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This Agreement constitutes the complete agreement between you and OrCAD Systems 
Corporation. If you do not agree to the terms of this agreement, do not open the disk 
package. Promptly return the unopened disk package and all other materials (including 


manuals, binders, and any written materials) 
fuil refund. 


OrCAD LICENSE AGREEMENT 


l. DEFINITIONS: 
A “OrCAD” shall mean OrCAD Systems Corpor- 
ation, 1049 SW. Baseline Street, Suite 500, Hillsboro, 
Oregon 97123, which is the owner of the copyright and 


author of this program. 

B. “LICENSEE” shal! mean the end user of Or- 
CAD/SOT, either individual or company, as !t is snown on 
the books of OrCAD. 

C. “OrCAD/SDT” shall mean the software and 


‘ related manuals and materials supplied in this package. 


0. “COMPUTER” shall mean the computer on 
which this program is used. 

E “LICENSE” shall mean this AGREEMENT and 
the rights and obligations created hereunder by the United 
States Copyright Law and Oregon Law. 

il. LICENSE: 

OrCAD grants to LICENSEE the nonexclusive right 
to use this copy of OrCAD/SDT on any single computer at a 
single location as long as LICENSEE complies with the 
terms of this LICENSE. OrCAD reserves the right to ter- 
minate this LICENSE if LICENSEE violates any provisions 
hereof and, in the event of such termination, LICENSEE 
agrees to return OrCAD/SOT to OrCAD. OrCAD/SOT is the 
sole and exclusive property of OrCAD. LICENSEE owner- 
ship is limited to the diskette(s) purchased. 

il, COPIES: 

LICENSEE agrees to make no more than two (2) 
copies of the software for archival or backup purposes and 
turther agrees to labe! said copies with all information in- 
cluded on the original diskette label. In the event that 
LICENSEE uses the original diskette and any copy or 
copies LICENSEE has made at the same time on different 
computer, LICENSEE agrees to request from OrCAD and 
pay for licenses for the appropriate number of additional 
user copies. A sealed copy of the program diskette(s) is 
supplied with the materials. By the act of opening the 
package within which the program diskette(s) is sealed, 
eo subscribes to and agrees to the terms of this 

icense. 
IV. TRANSFER, RESTRICTIONS ON USE AND TRANSFER: 

YOU MAY NOT USE, COPY, MODIFY, OR 
TRANSFER OrCAD/SDT OR ANY COPY, MODIFICATION 
OR MERGED PORTION, IN WHOLE OR IN PART, EXCEPT 
AS EXPRESSLY PROVIDED FOR IN THIS LICENSE. 

The original and any back-up copies of the Or- 
CAD/SOT and its documentation are to be used only in 
connection with a single computer. You may physically 
transter OrCAD/SDT from one computer to another, provid- 
ed that OrCAD/SDT is used in connection with only one 
computer at a time. You may not transfer OrCAD/SOT elec- 
tronically from one computer to another over a network. 
You may not distribute copies of OrCAD/SDT or Documen- 
tation to others. Neither OrCAD/SOT nor its documenta- 
tion may be modified or translated without written permis- 
sion from OrCAD. : 

LICENSEE agrees to take all reasonable steps and 
to exercise due diligence to protect OrCAD/SOT from 
unauthorized reproduction, publication, disclosure or 
distribution. Unauthorized transter and/or reproduction, of 
these materials may be a crime subjecting LICENSEE to 
civil and criminal prosecution. LICENSEE may not transfer 
any copy of OrCAD/SDT to any other person or compan 
without the prior written consent of OrCAD. OrCA 
reserves the right to revoke this LICENSE and/or to seek 


~"any other legal remedies to which it is entitled should 
’ these conditions de violated. 


V. LIBRITEO WARRANTY. 

OrCAD/SDT IS SOLD “AS !S” WITHOUT WARRAN- 
TY AS TO PERFORMANCE, MERCHANTABILITY, OR 
FITNESS FOR ANY PARTICULAR PURPOSE. THE ENTIRE 
RISK AS TO THE RESULTS AND PERFORMANCE OF THIS 
PROGRAM IS ASSUMED BY YOU. 

HOWEVER, TO LICENSEE ONLY AND PROVIDED 
LICENSEE HAS SENT IN THE SIGNED LIMITED WARRAN- 


OrCAD/SDT 


that are part of this product to OrCAD for a 


TY REGISTRATION CARD TO OrCAD, OrCAD WARRANTS 
THE MAGNETIC DISKETTE(S), ON WHICH THE PRO- 
GRAM IS RECORDED, TO BE FREE FROM DEFECTS IN 
MATERIALS AND FAULTY WORKMANSHIP UNDER NOR- 
MAL USE FOR PERIOD OF NINETY DAYS FROM THE 
DATE OF PURCHASE. IF DURING THIS NINETY DAY 
PERIOD THE DISKETTE(S) SHOULD BECOME DEFEC- 
TIVE, IT MAY BE RETURNED TO OrCAD FOR REPLACE- 
MENT WITHOUT CHARGE. 

LICENSEE'S SOLE AND EXCLUSIVE REMEDY IN 
THE EVENT OF A DEFECT IS EXPRESSLY LIMITED TO 
THE REPLACEMENT OF THE DISKETTE(S) AS PROVIDED 
ABOVE. IF FAILURE OF A DISKETTE HAS RESULTED 
FROM ACCIDENT OR ABUSE OrCAD SHALL HAVE NO 
RESPONSIBILITY TO REPLACE THE DISKETTE UNDER 
THE TERMS OF THIS LIMITED WARRANTY. 

ANY IMPLIED WARRANTIES RELATING TO THE 
DISKETTE, INCLUDING ANY IMPLIED WARRANTIES OF 
MERCHANTABILITY AND FITNESS FOR A PARTICULAR 
PURPOSE, ARE LIMITED TO A PERIOD OF NINETY DAYS 
FROM THE DATE OF PURCHASE. OrCAD IN NO EVENT 
SHALL BE LIABLE FOR INCIDENTAL, INDIRECT, 
SPECIAL OR CONSQUENTIAL DAMAGES RESULTING 
FROM THE USE OF THIS PRODUCT, INCLUDING LOST 
PROFITS OR LOSS OF USE OR OTHER REASONABLE 
LOSS, WHETHER THE CAUSE OF SUCH DAMAGES WAS 
KNOWN TO OrCAD OR NOT AND IN NO EVENT SHALL 
OrCAD’s LIABILITY ARISING IN CONNECTION WITH Or- 
CADISDT EXCEED AN AMOUNT EQUAL TO THE PUR- 
CHASE PRICE OF OrCAD/SDT. SOME STATES DO NOT 
ALLOW THE EXCLUSION OR LIMITATION OF INCIDEN- 
TAL OR CONSEQUENTIAL DAMAGES, SO THE ABOVE 
LIMITATIONS MIGHT NOT APPLY TO LICENSEE. THIS 
WARRANTY GIVES LICENSEE SPECIFIC LEGAL RIGHTS, 
AND LICENSEE MAY ALSO HAVE OTHER RIGHTS 
WHICH VARY FROM STATE TO STATE. LICENSEE and Or- 
CAD agree that OrCAD/SDT is not intended as “Consumer 
Goods” under state or federal warranty laws. 

Vi. UPDATES: 

OrCAD maintains a policy of ongoing updates and 
product improvement. With evidence of purchase date, Or- 
CAD will provide LICENSEE with free updates and product 
improvements for ninety (90) days after purchase. Provided 
LICENSEE has previously returned the signed limited war- 
ranty registration card, OrCAD shall provide LICENSEE 
with free updates and product improvements for one year 
after purchase. 

Vil. MISCELLANEOUS: 

In the event legal action is brought by either 
LICENSEE or OrCAD to enforce the terms of this licensing 
agreement, the prevailing party shall be entitled to recover 
reasonable attorney's fees and expenses in addition to any 
other relief deemed appropriate by the trial court or any ap- 
pellate court. Jurisdiction for all disputes shall be ex- 
clusively in Oregon which jurisdiction LICENSEE hereby 
submits to. This agreement shall be interpreted pursuant 
to Oregon law. 

This agreement shall represent the only agreement 
between LICENSEE and OrCAD and it may not be modified 
by the representation of anyone unless a written amend- 
ment has been signed by a corporate officer of OrCAD 


Systems Corporation. 
OrCAD Systems Corporation 


Should you have any questions conceming this 
Agreement, or if you desire to contact OrCAD for any 
reason, please contact in writing: 


Customer Sales and Service 

OrCAD Systems Corporation 

1049 S.W. Baseline Street, Suite 500 
Hillsboro, Oregon 97123 


-I1} V3.2! 


a 


Customer Reaistratian Number 


53421976 
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To run demonstration v1 
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Place diskette in DRIVE ‘A’ 

Enter A: 22 

Enter OrCAD 2 

Press letter to select display adapter 
The demonstration begins 


For additional instructions, enter: TYPE A:READ.ME _ 
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™ 1. INTRODUCTION q 


OrCAD Systems Corporation newest release of the 
popular schematic capture program is named 
OrCAD/SDT III. This enhanced package, is a complete 
and flexible schematic capture package. Easy to use 
menu driven commands help you to create, edit, save, 
print, and plot electronic schematics. 


Developed specifically to run on IBM personal ; 
computers and compatibles, OrCAD/SDT III supports 
most of the popular graphics boards, printers, and 
plotters. This eliminates the need for special, 
proprietary hardware by enabling you to use standard 
output equipment. 


1.1 FEATURES OF ORCAD/SDT Il 


The OrCAD/SDT III software package consists of the 
schematic drafting program DRAFT, a graphical 
library object editor called LIBEDIT, netlist, design 
check, part listing, and other utility and library 
programs. Outlined below is a summary of each 
program supplied with your OrCAD/SDT III package. 


etic DRAFT 
DRAFT is the schematic drafting program that enables 
you to create, edit, and save schematic worksheets. The 


major features of DRAFT include: 


¢ User definable template dimensions at 1 mil 
resolution 


¢ User definable text size 
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¢ Eight part fields 
¢ Over 3500 Unique library parts 
¢ DeMorgan Equivalent parts 


¢ Placement of wires, buses, connectors, labels, and 
junctions 


¢ Real-time rubberbanding of wires and buses when 
objects are moved 


e Part rotation and mirroring 


¢ Moving, replicating, and deleting objects or blocks of 
objects 


¢ Powerful step-and-repeat command 

e Visible grid dots and angled bus entries 

¢ Automatic panning of the worksheet 

e Five zoom levels 

¢ Over 100 user-assignable macros 

¢ Unlimited levels of hierarchy 

e On-Line part browsing and library directory 

e PSpice analog simulation shell (PSpice not included) 
e String searching 

¢ Vertical text placement 

e Suspension of session for DOS command execution 


¢ Supports "A" through "E", and custom size 
worksheets 
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1.1.2 Part Libraries 


Included with OrCAD/SDT III are extensive part 
‘libraries of the most commonly used devices in the 
industry. These libraries include TTL, CMOS, 
memory, ECL, discrete, analog, microprocessor, and 
peripheral devices. 


1.1.3. Creating Custom Libraries 


OrCAD/SDT ITI enables you to create your own 
"custom" libraries, or modify existing ones, in two easy 
ways. 


First, you can invoke the graphical object editor called 
LIBEDIT. With this editor, you can use commands 
similar to those of OrCAD/SDT III to construct or 
modify a part on the screen and add it to a new or 
existing library. The LIBEDIT object editor also enables 
you to to easily create the new IEEE/ANSI standard 
symbols if you desire. LIBEDIT automatically converts 
the graphical screen symbols to a data format readable 
by OrCAD/SDT III. 


Second, you can use a text editor to create a library 
source file. A library source file is an ASCII text file 

that contains instructions in the OrCAD Symbol 
Description Language. You then run the utility called 
COMPOSER on that library source file to produce a 
library data file readable by OrCAD/SDT III. 


1.1.4 Utility Programs 


OrCAD/SDT III's flexibility continues after the 
schematic design process with easy-to-use utility 
programs, including: 
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ANNOTATE: 


This program scans a hierarchy or flat file and 
automatically updates all part reference designators 
(U?, R? etc., explained later). ANNOTATE also 
updates the pin numbers associated with the reference 
designators. ANNOTATE can handle very large, 
complex, and multiple worksheets. 


BACKANNO: 


The BACKANNO utility updates part reference 
designators in your design. The input to the program, a 
list of old and new reference designators, is used to 
update your schematic worksheets. 


CLEANUP: 


This utility checks the worksheet for wires, buses, 
junctions, labels, module ports, and other objects that 
are placed on top of each other. CLEANUP removes 
duplicate or overlapping wires, buses, junctions, and 
displays warning messages advising you of other 
duplicate objects. 


COMPOSER: 


If you choose to create library parts using a text editor, 
COMPOSER is the library utility that converts your 
custom library source files into the highly compressed 
library object files used by DRAFT. After COMPOSER 
compiles a source file into an object file, your custom 
library is ready for loading into DRAFT and the other 
utilities. 
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CROSSREF: 


information for all parts used in the schematic files, and 
creates a cross reference listing that tells you where 


This utility scans through the schematic files, gathers a | 
each part is located. 


DECOMP: 


If you choose to create library parts using a text editor, 
DECOMP is a library de-compiler that enables you to 
convert the OrCAD-supplied library object files (files 
with a .LIB extension) to library source files. You can 
then edit the source files using a standard text editor to 
make additions or modifications to the library. 


ERC: 


This is a utility that performs an electrical rules check 
of your schematic worksheets. The program checks 
for shorts, inputs with no driving source, unconnected 
pins, bus contention, and other common errors. 


LIBARCH: 


This utility takes all the library parts used in the 
schematic files and makes a single library source, an 
archived library, containing only parts which are 
usable for those schematic files. 


LIBEDIT: 


This utility enables you to create library components on 
the screen. With this object editor, you can use 
commands similar to those of OrCAD/SDT III to 
construct or modify a part on the screen and add it toa 
new or existing library. LIBEDIT automatically 
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converts the graphical screen symbols to a data format 
readable by OrCAD/SDT III. 


NETLIST: 


This program generates a netlist of the worksheet 
signal and part connections in these formats: Algorex, 
Applicon (Leap and BRAVO!), Cadnetix, Calay, 
Computervision, EE Designer, EDIF, Flat EDIF, 
FutureNet (Pinlist and Netlist), Intergraph, Multiwire, 
PCAD, Spice, Racal-Redac, SALT, Scicards, Tango, 
Telesis, and Vectron formats. NETLIST also generates 
a general wire list. 


PARTLIST: 

This utility summarizes all the parts used in a 
schematic or group of schematic sheets. You can also 
merge user-specific information with the PARTLIST 
report. 

PLOTALL: 

PLOTALL plots a schematic or group of schematic 
sheets, including a hierarchy, flat file, or annotation file, 
in batch mode. 

PRINTALL: 

PRINTALL prints a schematic or group of schematic 
sheets, including a hierarchy, flat file, or annotation file, 
in batch mode. 


TREELIST: 


A program that scans a hierarchical organization of 
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sheets to display the structure, sheet names, and sheet 
path names of the hierarchy. 


1.2 HOW TO USE THIS MANUAL 


This manual provides first time and experienced users 
with a complete, easy-to-use reference guide and 
tutorial. First time users are advised to read Sections 2 
- 6. Experienced users may need to refer to Sections 4 
and 6 for a review of the DRAFT command set and the 
utilities. 


Users who wish to create their own "custom" part 
libraries should read Section 7. Section 8 is a step-by- 
step introductory tutorial recommended for all users. 
Section 2: 

Describes the installation and configuration of 
OrCAD/SDT III on your personal computer. 

Section 3: 

Gets you started by describing how to invoke DRAFT 
and how to select commands from the pop-up menus. 
You will also learn how to save, load, print, and plot files. 


Section 4: 


Describes the DRAFT command set. 
Section 5: 


Discusses DRAFT's hierarchical features, and explains 
both simple and complex hierarchies. 
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Section 6: 


Shows you how to use the utility programs included 
with OrCAD/SDT III. Each utility is discussed in 
separate sub-sections. 


Section 7: 


Introduces LIBEDIT, COMPOSER and DECOMP, 
and outlines the procedure for creating your own 
libraries. This section concludes with instructions for 
creating your own "custom" libraries. 


Section 8: 


A detailed tutorial discussing the use of the DRAFT 
command set and utilities. The tutorial creates a 
worksheet, where you will learn many ofthe concepts 
used in schematic capture. 


Appendix: 

Lists all of the library parts included with DRAFT. 
Outlines the configurations of the supported graphics 
boards, and lists the printer, plotter, and graphics board 
drivers supplied. Also included is the source code for the 
OrCAD printer and plotter drivers. 


Index: 


A complete Index to the manual. 


1.3 TROUBLESHOOTING 


If you have questions regarding how to run the 
program, be sure that you have properly configured 
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your system. Check to see that you have the correct 
driver for the graphics board installed in your system. 
Refer to Section 2 and the Appendix for configuration 
information and for graphics board jumpering 
information. 


Be sure that you are using the correct printer or plotter 
driver. If youhave a printer or plotter problem, see the 
PRINTALL and PLOTALL utility program 
information in Section 6. 

If you have a computer or mouse problem, consult your 
user's manual or contact your dealer. 

1.3.1 If You Have Questions 

If you need help after you have checked the items 
discussed above, we may be able to assist you. If you 
contact OrCAD for technical support, be prepared to 
give the support engineer the following information: 


1. The name of the Licensed User of your 
OrCAD/SDT III 


Registration number 

Program Version Number 

Type of personal computer 

Size of RAM in personal computer 


Types of peripheral boards installed 


Ru OF ee oe 


Printer or plotter name and model number 


1-9 


Introduction Schematic Design Tools 


8. Configuration of your OrCAD/SDT III System 
(obtained from the main menu when you invoke 
"DRAFT /C") 


The OrCAD Telephone Number is: 1-503-640-5007. 
Technical Support hours of operation are Monday 
through Friday 8 - 4 Pacific time. Ask for Technical 
Support. 


NOTE 


The person who fills out and sends in the 
registration card is the only one entitled to 
customer support. The registration card 
must be received by OrCAD for continued 
telephone support. Your free telephone 
support will be extended to one year if you 
send in the warranty registration card 
within 90 days of product purchase. 


At OrCAD Systems Corporation, we are committed to 
giving our customers the finest products and support. 
Before your free support period expires, be sure you 
apply for the OrCAD Technical Support Extension 
(OrCAD/TSE). Contact OrCAD Systems Corporation 
for information. 


1.4 ORCAD BULLETIN BOARD LOGON 
PROCEDURES 


OrCAD has available to registered users, a bulletin 
board service that operates 24 hours a day. If you have 
a 300, 1200, or 2400 baud modem, you can retrieve this 
information: 
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1. |New software updates, including support for new 
printers, plotters, graphic cards, and libraries. 
These are placed on the bulletin board as soon as 
they are released. 


2. Application notes covering answers to the most 
frequently asked support questions. 


3. General information about OrCAD, mail from 
other OrCAD/SDT III users, and libraries 
submitted by our customers. 


In addition, you can submit the following information to 
the bulletin board and share it with other OrCAD users: 


1. Mail for OrCAD, or for other OrCAD customers. 
2. Technical questions and problems. 


3. Libraries that you have created. 


1.4.1 Modem Requirements 


To access the OrCAD bulletin board you need a 300, 
1200, or 2400 baud modem that uses X\MODEM 
protocol. Set your modem for 8 data bits, 1 stop bit, and 
no parity. 


1.4.2 Telephone Number and Operation Hours 


The OrCAD bulletin board phone number is 503-640- 
5002. The bulletin board operates 24 hours a day, 
except when it is shut down for maintenance. If you're 
not able to establish communications after the first ring, 
the bulletin board is down for maintenance. 
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1.4.3 Logon Instructions 


The first time that you logon to the bulletin board, you 
will not be allowed access to all of the system features. 
This is because you must "officially" register by entering 
your password and registration number. After you 
enter this information, you must leave a message, as a 
comment, for the bulletin board system operator 
(SYSOP) requesting that your security level be raised to 
that of "registered user". Allow 2 to 3 working days for 
the SYSOP to upgrade your security clearance. 


Once your security level is changed to "registered user”, 
the bulletin board is available for you to access all 
system features. Detailed logon and registration 
instructions are given below. 


After text strings that you enter at the bulletin board 
prompts, be sure to press the <ENTER> key. Boldface 
type indicates where you are prompted for a text entry. 


After you've dialed the OrCAD bulletin board and 
communication is established, this message appears: 


WELCOME TO ORCAD.RBBS-PC 


WHAT IS YOUR FIRST NAME?<Enter your first name here> 
WHAT IS YOUR LAST NAME? <Enter your last name here> 
CHECKING USERS... 


TYPE SYSTEM CALLING FROM (C/R IF IBMPC) ?<Press ENTER if 
you have a PC> 


WHAT IS YOUR CITY AND STATE? <Enter your city and 
state> 
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<At this point, the following message should appear on your 


screen> 


~ININININININININININININININININININININININININININININ 
WELCOME 
TO 
ORCAD USERS BULLETIN BOARD 


-->NEW USERS ARE REQUIRED TO REGISTER BEFORE USING THIS 
SYSTEM<-- 


YOU MAY USE THE SYSTEM IMMEDIATELY AFTER REGISTRATION. TYPE 
'B' FROM THE MAIN MENU FOR THE SYSTEM DIRECTORY. FEEL FREE 
TO VISIT, LOOK AROUND AND BE SURE AND LEAVE US ANY COMMENTS 
YOU HAVE. THANKS FOR CALLING! 


ORCAD SYSTEMS CORPORATION 
HILLSBORO OREGON 


<<< DESIGNERS OF HIGH PERFORMANCE LOW COST CAE TOOLS >>> 
V/A\IN\INININININININININININININININININININININININININE$ 
MORE (Y),N,NS? <Enter a "Y¥" for Yes to continue> 


<R>EGISTER, <C>HANGE NAME/ADDRESS, <D>ISCONNECT (DON'T 
REGISTER) ? 


<At the above prompt, enter "R" after the question mark to 
register> 


ENTER PASSWORD YOU'LL USE TO LOGON AGAIN?<Enter a 
password of your choice here> 


PASSWORD VERIFICATION (DOTS ECHO) ?<Enter it again. Dots 
will echo> 


REMEMBER YOUR PASSWORD 


CAN YOUR TERMINAL DISPLAY LOWER CASE? <Enter "Y" or "N" 
here> 


UPPER CASE and lower 
GRAPHICS wanted: <N>one,<A>scii,<C>olor, <H>elp? <Enter 
an "N" here> 


GRAPHICS: None 

FILE transfer default type <A)scii, <X>modem, <Q>uit? 
<Enter an "X" here> 

PROTOCOL: Xmodem 


Want nulls?<Enter an "N" here> 
Nulls Off 
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Logging YOUR NAME HERE 


RBBS-PC VERSION CPC12.5B NODE 1 
OPERATING AT XXXX BAUD,N,8,1 


* <Ctrl K> or <Ctrl X> aborts <Ctrl S> suspends * 


/NINININININININININININININININININININININININININININ 
B\/\/\/\/N\/\/N/N/N/\//— Welcome to) \/\/\/\/\/\/\/\/\/\/\ 


0 x CoAT DESULS BE LR Sass Ul Ueb ube TetaNeeB) OvAERED 
-From- 
OrCAD SYSTEMS CORPORATION 
Hillsboro, Oregon 


<<< DESIGNERS OF HIGH PERFORMANCE LOW COST CAE TOOLS >>> 


ININININININININISTININININININININIAP SAN RELA N 
\/\. Type *B' from the MAIN MENU to read Bulletins \/ 


More (Y),N,NS? <Enter an "N" here> 

Skip the 99 bulletins? <Enter a "Y" here, unless you 
want to read bulletins> 

Checking messages. 


RBBS-PC Ver CPC12.5B Node 1 


Caller # xxx # active msgs: x Next msg # xx 


B)ulletins I)nitial welcome R)ead messages 

C) omments J)oin a conference S)can messages 

D)oor subsystem K)ill a message 
U)tilities 

E)nter message L)ines per page V) iew a conference 
F)iles subsystem O)perator page 
W)ho's on other nodes 

G) oodbye * P)ersonal mail X) Expert mode toggle 
H)elp Q)uick scan of messages ?)Functions 


Main Func <B,C,D,E,F,G,H,I,J,K,L,0,P,Q,R,S,U,V,W,X, 2>? 
<Press a "C" at the above prompt to leave a 
comment > 


Leave private comment for Sysop (Y/N)? 
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<Enter a "Y" at the above prompt. Leave a message 
to-the SYSOP similar to the following:> 


Type comment (C/R to end, 19 lines max) 
1: Leave your Name, Company, City, State, and 
2: Registration Number. 


A)bort, C)ontinue, D)elete, E)dit, I)nsert, L)ist, M)argin, 
S) ave 


Subfunc <A,C,D,E,1I,L,M,S,?>?<Press "S" to Save your 
comment > 


Thanks for comments! 


B)ulletins I)nitial welcome R)ead messages 

C) omments J)oin a conference S)can messages 
D)oor subsystem K)ill a message 
U)tilities 

E)nter message L)ines per page V)iew a conference 
F)iles subsystem O)perator page 
W)ho's on other nodes 

G) oodbye * P)ersonal mail X) Expert mode toggle 
H)elp Q)uick scan of messages ?)Functions 


Main Func 
<B,C,D,E,F,G,H, I,J3,K,L,0,P,Q9,R, $,U,V,W,X, 2>2 


<At this point, type a "G" to logoff, or any other 
key if you want to snoop around> 


We need all of this information to properly register you. 
As mentioned earlier, allow 2 - 3 working days for us to 
upgrade your security clearance. After your security 
clearance is changed, you may use all of the bulletin 
board features the next time you call. 
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2. SETTING UP OrCAD/SDT 


Now that you have been introduced to OrCcAD/SDT 
III's DRAFT and its utility programs, you will learn 
how to install and configure these programs on your 
system. 


This section describes how to install OrCAD/SDT III on 
a dual-floppy or hard disk system. Installing 
OrCAD/SDT III consists of first making backup copies 
of your OrCAD/SDT III program diskettes and then 
loading graphics, printer, and plotter drivers for your 
hardware and symbol libraries for your designs. This 
section concludes by showing you examples of sample 
configurations. 


2.1 WHAT YOU NEED TO BEGIN 

Let's review the items that you'll need to install 
OrCAD/SDT III. The following items are supplied with 
your OrCAD/SDT III package: 


1. Software packet containing these seven OrCAD 
disks: 


e MASTER SOFTWARE DISK 1 
e MASTER SOFTWARE DISK 2 
e LIBRARY DISK 1 

e LIBRARY DISK 2 

¢ DRIVER DISK 1 

e DRIVER DISK 2 
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e DRIVER DISK 3 


2. Disk File Reference Sheet - Located in the sealed 
package that contained the OrCAD supplied 
disks. 


3. OrCAD Schematic Design Tools documentation. 
You need to supply the following: 


1. AnIBM PC/XT/AT or compatible personal 
computer with two double-sided, double-density 
360K floppy disk drives or a hard-disk system. 


2. Or, and IBM PS/2 compatible computer with two 
720K floppy disk drives or a hard disk (this is 
optional; you must have specifically requested this 
format when you ordered OrCAD/SDT III. 


3. DOS Version 2.0 or greater. 


4. Aminimum of 512K bytes of PC memory (640K if 
you use LIBEDIT). 


5. Seven formatted, double-sided disks for making 
backup copies of the OrCAD-supplied programs. 


6. Five extra formatted, double-sided disks, if you 
are installing OrCAD/SDT III on a dual-floppy 
system. 


2.2 PREPARING FOR INSTALLATION 


Before you install OrCAD/SDT III on your system, you 
should be familiar with the DOS commands CHDIR 
(CD), COPY, DIR, DISKCOPY, FORMAT, and 
MKDIR (MD). If your system has a hard disk, you 
should also familiarize yourself with tree-structured 
directories. For a description of these commands and 
features, refer to your DOS user's manual. 
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2.2.1 Making Backup Copies 


To protect your software investment, we recommend 
that you make a backup copy of your program 
diskettes. You may make backups as detailed in the 
License Agreement. Opening the sealed software 
package and using the program constitutes acceptance 
of the agreement. 


To make backup copies of your OrCAD/SDT III 
program diskettes, use the DOS COPY or DISKCOPY 
commands. Refer to your DOS user's manual for 
instructions. j 


2.3. INSTALLING ORCAD/SDT Ill 


OrCAD/SDT III may be installed on a dual-floppy or 
hard disk system. If you are installing OrCAD/SDT III 
on a system having two floppy drives, refer to Section 
2.3.1. If you are installing OrCAD/SDT III on a hard 
disk system, refer to Section 2.3.2. 


After you have installed OrCAD/SDT IT], refer to 
Section 2.4 for information on configuring your system. 


2.3.1 Installing OrCAD/SDT Ill on a Dual Floppy 
System 


For installation, please refer to the "Disk File Reference 
Sheet", located in the sealed package that contained the 
OrCAD supplied disks. 


OrCAD/SDT III may be installed on a two floppy disk 
system in a number of ways. We recommend that you 
do not use the OrCAD masters for your program, or 
"working" disks. Instead, make your own working 
disks from the OrCAD supplied masters. 
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For example, use five formatted, double-sided disks to 
make working copies of OrCAD/SDT III. These 
working copies are needed to load the drivers, libraries, 
and worksheet filenames. Since the files do not all fit on 
a single disk, separating them according to the 
procedure suggested below keeps disk swapping to a 
minimum. 


Label five formatted floppy disks as follows: 


DRAFT 1 

DRAFT 2 
DRIVER/LIBRARY 
SHEET 

LIBRARY UTILITY 


Referring to the "Disk File Reference Sheet" to help you 
locate the desired OrCAD-supplied files, copy 
DRAFT.EXE and the ORCADSDT.OVL files from your 
OrCAD-supplied MASTER SOFTWARE DISKS to 
your working disk DRAFT 1. Executable files have the 
.EXE extension after the filename and overlay files use 
-OVL. 


Also, copy the PDRAFT.OVL, PSPICE.BAT, and any 
desired macro files (with a .MAC extension), from the 
OrCAD-supplied MASTER SOFTWARE DISKS to the 
DRAFT 1 working disk. 


Next, copy any desired utility programs from the 
OrCAD-supplied MASTER SOFTWARE DISKS to the 
DRAFT 1 working disk. Initially, we suggest that the 
ANNOTATE.EXE, CLEANUP.EXE, ERC.EXE, 
PARTLIST, and TREELIST utilities be copied. 
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Since all of the utilities will not fit on the DRAFT 1 disk, 
copy BACKANNO.EXE, CROSSREF.EXE, 
NETLIST.EXE, PLOTALL, PRINTALL, and 
ORCADSDT.OVL to another working disk labeled 
DRAFT 2. NOTE, that the ORCADSDT.OVL file is also 
copied. All utilities require the overlay file to be present 
on the same disk, in order to work. 


Next, referring to the "Disk File Reference Sheet" and 
Appendix B, copy PRINTER.DRV and the required 
printer, plotter, and graphic card drivers from the 
OrCAD-supplied DRIVER DISKS to a working disk 
labeled DRIVER/LIBRARY. Then, referring to 
Appendix A, copy the desired object libraries (files with a 
.LIB extension) from the OrCAD-supplied LIBRARY 
DISKS to the DRIVER/LIBRARY working disk. 


Finally, copy LIBARCH.EXE, LIBEDIT.EXE, 
LIBLIST.EXE, COMPOSER, DECOMP, and 
ORCADSDT.OVL from the OrCAD-supplied MASTER 
SOFTWARE DISKS to your working disk LIBRARY 
UTILITY. This disk will be used when you want to 
make custom library parts or modify existing ones. 
Therefore, you also need to copy any libraries you need 
from the OrCAD-supplied LIBRARY DISKS to the 
LIBRARY UTILITY. 


NOTE 


Whenever you modify libraries on this disk, 
be sure to copy them to the working 
DRIVER/LIBRARY disk. 


The working SHEET disk remains blank for now. You 
will use this disk for storing your worksheet files. 
Figures 2-1, 2-2, 2-3, 2-4 illustrated below, show the 
program files and their working disk locations. 
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Files Required Where Found 

JOON Hil Copies "ac MASTER SOFTWARE DISKS 
ORCADSD ISON iy Ge er rei MASTER SOFTWARE DISKS 
NDS V aN MEOW AG ue eS MASTER SOFTWARE DISKS 
IS¥e CAD Dey I I gine MASTER SOFTWARE DISKS 
Desired Macro File -=---=-—---— MASTER SOFTWARE DISKS 
ANNOTATE) EXE) *==-==--===<=-=——- MASTER SOFTWARE DISKS 
CLEANUP .EXE 9 -==---<-<-----=-- MASTER SOFTWARE DISKS 
LSGE, ATP MASTER SOFTWARE DISKS 
EVANS ELM EYES EF OD. CS MASTER SOFTWARE DISKS 
SD pind SI eg) ch a MASTER SOFTWARE DISKS 


Figure 2-1. DRAFT 1 Disk Files 


Files Required Where Found 

ORCADSDT {OVI —=->———=——— = = = MASTER SOFTWARE DISKS 
EV NGO AININ (OY ONE, OER at MASTER SOFTWARE DISKS 
OSLOSISINIS I 0, SS SSS SSS MASTER SOFTWARE DISKS 
EPSRC SSS SNE Ot MASTER SOFTWARE DISKS 
PLOTATIN EXE (a ase ae ne MASTER SOFTWARE DISKS 
ASE DOIN AU Pao is ps a a oa MASTER SOFTWARE DISKS 


Figure 2-2. DRAFT 2 Disk Files 


Files Required Where Found 

PRINTER .DRV 9 =——~————-== === — = =e == = —— DRIVER DISKS 
Required Printer Driver -------------- DRIVER DISKS 
Required Plotter Driver -------------- DRIVER DISKS 
Required Graphics Card Driver -------- DRIVER DISKS 
Library Files (.LIB extension) ------- LIBRARY DISKS 


Figure 2-3. Required DRIVER/LIBRARY Disk Files 
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Files Required Where Found 

ORCADSDT.OVL ---------------- MASTER SOFTWARE DISKS 
LIBARCH.EXE  ---------------- MASTER SOFTWARE DISKS 
LIBEDIT.EXE ---------------- MASTER SOFTWARE DISKS 
LIBLIST.EXE ---------------- MASTER SOFTWARE DISKS 
COMPOSER.EXE -----~------------------- LIBRARY DISKS 
DECOMP.EXE -------------------------- LIBRARY DISKS 
Library Files (.LIB extension) ------- LIBRARY DISKS 


Figure 2-4. Required LIBRARY UTILITY Disk Files 


This completes the preparation of your working disks. 


Place the DRAFT 1 working disk in drive A, and the 
DRIVER/LIBRARY working disk in drive B. Go to 
Section 2.4 and follow the procedures for configuring 
your OrCAD/SDT III software. 


2.3.2 Installing OrCAD/SDT Ill on a Hard Disk 
System 


The most efficient way to organize your hard disk 
when using OrCAD/SDT III is to create a series of 
subdirectories. This enables you to easily organize your 
drivers, libraries, and worksheets. 


Create a new directory on your hard disk called 
ORCAD. Within the OrCAD directory, create three 
more subdirectories: DRIVER, LIBRARY, and SHEET. 


Referring to the "Disk File Reference Sheet” to help you 
locate the desired OrCAD-supplied files, copy all of the 
files from each OrCAD-supplied MASTER 
SOFTWARE DISK to the ORCAD directory. 
Executable files have a .EXE extension after the 
filename and overlay files use .OVL. This is called the 
ORCAD root directory. 
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Next, copy all of the files from each OrCAD-supplied 
DRIVER DISK to the DRIVER subdirectory, and all of 
the files from each OrCAD-supplied LIBRARY DISK 
the LIBRARY subdirectory. 


Finally, the SHEET subdirectory is where you will put 
your schematic worksheet files. For now, the SHEET 
subdirectory remains empty. 


Figure 2-5 shows the configuration tree we 
recommend for organizing your hard disk files. Follow 
STEPS 1 - 9 below to install OrCAD/SDT III on your 
hard disk system. 
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DRAFT.EXE 
ORCADSDT.OVL 
PDRAFT.OVL 
PSPICE.BAT 
MACRO1.MAC 
MACRO2.MAC 
ANNOTATE.EXE 
BACKANNO.EXE 
CLEANUP.EXE 
CROSSREF.EXE 
ERC.EXE 
LIBARCH.EXE 
LIBEDIT.EXE 
LIBLIST.EXE 
NETLIST.EXE 
PARTLIST.EXE 
PLOTALL. EXE 
PRINTALL.EXE 
TREELIST.EXE © 


LIBRARY 


DRIVER 
COMPOSER.EXE Send all worksheet 


PRINTER.ORV ; : ; 
: , DECOMP.EXE files to this Subdirectory 
(Graphic Card, Printer, CMOS.LIB 


Plotter,any other DEVICE.LIB 
OrCAD supplied drivers) INTEL.LIB 


MOTO.LIB 

TTL.LIB 

ECL.LIB 
ANALOG.LIB 
MEMORY.UB 
ASSEMBLY.LIB 
PSPICE.LIB 
SHAPES.LIB 

(other user-created source 
and object libraries) 


Legend: 


Figure 2-5. Recommended Hard Disk Installation 


STEP 1: 


Be sure that you are in the root directory. At the DOS 
C> prompt, create a new directory called ORCAD 
using the DOS MD command. Type: 


MD ORCAD <ENTER> 


Enter ORCAD, the directory you just created, by typing: 
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CD ORCAD <ENTER> 
The DOS command CD enables you to change the 
current DOS directory to a new one you specify. 
STEP 2: 
Make three more subdirectories within ORCAD. Type: 
MD LIBRARY <ENTER> 
Then type: 
MD DRIVER <ENTER> 
Then type: 
MD SHEET <ENTER> 


STEP 3: 

Insert the OrCAD-supplied MASTER SOFTWARE 

DISK 1 into drive A. Copy the files from MASTER 

SOFTWARE DISK 1 to the ORCAD directory. Type: 
COPY A C <i NIER>. 

When the files are copied, remove the MASTER 

SOFTWARE DISK 1 from drive A. 

STEP 4: 

Insert the OrCAD-supplied MASTER SOFTWARE 

DISK 2 into drive A. Copy the files from MASTER 

SOFTWARE DISK 2 to the ORCAD directory. Type: 


COPY A:™.* Cr <ENTERS. 
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When the files are copied, remove the MASTER 
SOFTWARE DISK 2 from drive A. 
STEP 5: 
Insert the OrCAD-supplied LIBRARY DISK 1 into 
drive A. Copy the files from LIBRARY DISK 1 to the 
LIBRARY subdirectory. Type: 

COPY A**.* LIBRARY\*,.* <ENTER>. 


Remove LIBRARY DISK 1 from drive A. 


STEP 6: 
Insert the OrCAD-supplied LIBRARY DISK 2 into 
drive A. Copy the files from LIBRARY DISK 2 to the 
LIBRARY subdirectory. Type: 

COPY A:*.* LIBRARY\*.* <ENTER>. 
The Library object files (files with a .LIB extension), 
COMPOSER.EXE, and the DECOMP.EXEH files 
should now be in the LIBRARY subdirectory. Remove 
LIBRARY DISK 2 from drive A. 
STEP 7: 


Insert the OrCAD-supplied DRIVER DISK 1 into drive 
A. Copy the files from DRIVER DISK 1 to the DRIVER 
subdirectory. Type: 


COPY A:*.* DRIVER\*.* <ENTER> 
Remove DRIVER DISK 1 from drive A. 
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STEP 8: 


Insert the OrCAD-supplied DRIVER DISK 2 into drive 
A. Copy the files from DRIVER DISK 2 to the DRIVER 
subdirectory. Type: 


COPY A:*.* DRIVER\*.* <ENTER> 


The graphics drivers are now in the DRIVER 
subdirectory. Remove DRIVER DISK 2 from drive A. 


STEP 9: 


Insert the OrCAD-supplied DRIVER DISK 8 into drive 
A. Copy the files from DRIVER DISK 3 to the DRIVER 
subdirectory. Type: 


COPY A:*.* DRIVER\*.* <ENTER> 


The graphics, printer, and plotter drivers are now in 
the DRIVER subdirectory. Remove DRIVER DISK 3 
from drive A. 


NOTE 


If you are using PSpice, load the PSpice files 
and utilities in the OrCAD root directory 
(the directory containing DRAFT.EXE). 
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NOTE 


To save hard disk space, it is not required to 
load every graphic card, printer, and plotter 
driver on your hard disk. Refer to the "Disk 
File Reference Sheet” and Appendix B, to 
help you locate the desired OrCAD-supplied 
drivers that are required for your particular 
computer configuration. To optimize disk 
space, the minimum drivers that are 
required are: a graphics card driver to work 
with your graphics card, a printer driver to 
work with your printer, a plotter driver to 
work with your plotter, and the 
PRINTER.DRV file. The PRINTER.DRV 
file must be loaded if you are using a printer. 


This completes the OrCAD/SDT III installation on a 
hard disk system. 


If you plan to use a mouse with your OrCAD/SDT III 
software, refer to Section 2.3.3. Otherwise, go to Section 


2.4 and follow the procedures for configuring your 
OrCAD/SDT III software. 


2.3.3 Installing a Mouse 


OrCAD/SDT III supports the Microsoft, Mouse 
Systems, Torrington, and Logitech C7, serial and 
parallel mice. Be sure that the correct mouse driver, 
supplied by the mouse manufacturer, is installed and 
configured to the proper serial channel. 
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OrCAD/SDT III uses the MOUSE.COM driver for the 
Microsoft and Logitech mice, and the 
MSMOUSE.COM driver for the Mouse Systems 
Mouse. Many of these driver names use the /1 or /2 
option switches for configuring them for use on the 
proper (COM1 or COM2) serial channel. 


OrCAD/SDT III has no special mouse requirements. If 
you have mouse problems, refer to your mouse user's 
guide for information. 


2.4 CONFIGURING ORCAD/SDT Ill 


After you have installed the OrCAD/SDT III files on 
your system, you must configure the software to access 
the correct printer, plotter, graphic drivers, and 
libraries. 


The configuration information that you supply will 
vary, depending on whether you are using a floppy or 
hard disk system. Examples are given below for each 
configuration case. 


The procedures outlined in this section show you how to 
configure the following items: 


Driver Prefix 

Display Driver 
Printer Driver 
Plotter Driver 
Library Prefix 
Library Files 
Worksheet Prefix 
Macro File 

Initial Macro 

Macro Buffer Size 
Hierarchy Buffer Size 
Color Table / Pen Plotter Table 
Template Table 
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2.4.1. Invoking the OrCAD/SDT Ill Configuration 
File 


To configure OrCAD/SDT III, you must be in the 
ORCAD directory if you are using a hard disk system. 
The ORCAD directory must contain the files 
DRAFT.EXE, ORCADSDT.OVL, and the utility 
programs (see Figure 2-4), 


If yours is a dual floppy system, place the DRAFT 1 
working disk in drive A and the DRIVER/LIBRARY 
disk in drive B. 


In either case, at the DOS prompt, type: 
DRAFT /C <ENTER> 


/C is a switch that causes the configuration menu to be 
displayed on the screen. Use the /C switch when you 
want to change OrCAD/SDT III's configuration. 


When invoked, the "Configuration Of OrCAD/SDT III" 
menu appears on the screen as shown in Figure 2-6. 
Perform each of the steps described in Sections 2.4.2 - 
2.4.15 below. 
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11: CONFIGURATION OF OrCAD/SOT : :: 


- Driver Prefix 
- Display Driver 
- Printer Driver 
- Plotter Driver 
- Library Prefix 
- Library Files 


- Worksheet Prefix 

- Macro Files 

- Initial Macro 8192 

- Macro Buffer Size 1024 

- Hierarchy Buffer Size 

- Color Table/Plotter Pen Table 

- Template Table 

- Update Configuration Information 
- Quit, Abondon to DOS 

- Run Program 


Command? 


Figure 2-6. The Configuration Menu 


2.4.2 Driver Prefix 


The driver prefix sets the subdirectory path or disk 
drive, enabling OrCAD/SDT III to load the printer, 
plotter, and graphics drivers. 


To select driver prefix, type DP. A reverse video bar 
appears beside DP - Driver Prefix. Type the pathname 
of the directory that contains your device driver, then 
press <ENTER>. 
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Examples: 
(Looks for the drivers in 
DP - Driver Prefix B: Drive B. Use this prefix 
if you have a dual-floppy 
system) 
(Looks for the drivers in 
DP - Driver Prefix the DRIVER 
DRIVER\ subdirectory on hard 


disk systems. Be sure 
that the back slash "\" is 
present) 


2.4.3 Display Driver 


Display Driver configures OrCAD/SDT III for your 
system's graphics driver. 


To select Display Driver, type DD. A table appears that 
shows a list of the supported graphics drivers. Type the 
letter that corresponds to your graphics driver. If you 
are using a special driver, type S and enter the driver 
name. Then, type Q to quit and return to the 
configuration menu. 


2.4.4 Printer Driver 


Printer Driver configures OrCAD/SDT III with the 
printer driver for your printer. 


To select Printer Driver, type PD. A table appears that 
shows a list of the supported printer drivers. Type the 
letter that corresponds to your printer driver. If you 
are using a special driver, type S and enter your printer 
name. Then, type Q to quit and return to the 
configuration menu. 


If none of the drivers are to be used, type X. 
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2.4.5 Plotter Driver 


The plotter driver configures OrCAD/SDT III with the 
plotter driver used with your plotter. You may also 
specify serial channel number, baud rate, parity, and 
word length. 


To select Plotter Driver, type PL. A table appears that 
shows a list of the supported plotter drivers. Type the 
letter that corresponds to your plotter. If you are using 
a special driver, type S and enter the driver name. 


After you have selected a plotter driver, type a colon (:) 
to configure OrCAD/SDT III for serial channel 1 or 2. 
Next, you may select the baud rate, parity, and word 
length your plotter needs for data transfer. 


Then, type Q to quit and return to the configuration 
menu. If none of the drivers are to be used, type X. 


NOTE 


Be sure that the serial channel, baud rate, 
parity, and word length match the 
characteristics of your plotter. Refer to your 
plotter manual if you need more 
information. 


For additional plotter information, read the description 
of the PLOTALL utility in Section 6. 


2.4.6 Library Prefix 


Library Prefix sets the subdirectory path or disk drive 
that enables OrCAD/SDT III to load the part libraries. 
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To select Library Prefix, type LP. A reverse video bar 
appears beside LP - Library Prefix. Type the 
pathname of the directory that contains your library 
data files, then press <ENTER>. 


Examples: 
(Looks for the libraries 
LP - Library Prefix B: in Drive B. Use this 
prefix if you have a dual- 
floppy system.) 
(Looks for the libraries 
LP - Library Prefix in the LIBRARY 
LIBRARY\ directory on hard disk 


systems. Be sure that 
the trailing backslash "\" 
is present) 


2.4.7 Library Files 


To configure OrCAD/SDT III to load part libraries, type 
LF. The screen will display a list of libraries if any have 
been previously selected. 


To add a library, type A. A prompt appears requesting 
you to enter a new name, if none have been selected. 
Enter the library name, and press the <ENTER> key. 


If you enter more than one library, "Add File Name 
before? [1..2]" appears. Enter a number that 
corresponds to the order in which you want to add the 
new library. If you want to append a new library to the 
end of the list,type a number that is one greater than 
the last library. 


To remove a library, type R. A prompt then appears 


that requests the number of the library you want to 
remove. 
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Example: 


:: Library Files ::: 
DEVICE.LIB 
TPE EB 
MEMORY.LIB 


A- ADD File Name 
R - REMOVE File Name 


Q - Quit 
Command? 
The three part libraries listed above are loaded by - 
OrCAD/SDT III and many of the utility programs. To 


remove a library, type R. The screen then looks as 
follows: 


:: Library Files ::: 
1 - DEVICE.LIB 
2-TTL.LIB 
3 - MEMORY.LIB 
A- ADD File Name 
Remove Which File Name? [1..3] Selection -> 
Type the number that corresponds to the library you 
want to remove. Then, type Q to quit and return to the 
main configuration menu. 
2.4.8 Worksheet Prefix 
Worksheet Prefix sets the subdirectory path or disk 


drive specifier that enables OrCAD/SDT III to load the 
worksheet files. 
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To select Worksheet Prefix, type WP. A reverse video 
bar appears beside WP - Worksheet Prefix. Type the 
pathname of the directory that contains your 
schematic files. 


Examples: 


(Looks for the schematic 
WP - Worksheet Prefix B:  filesin Drive B. Use this 
prefix if you have a dual- 
floppy system.) 
(Looks for the schematic 
WP - Worksheet Prefix files in the SHEET 
SHEET\ directory on hard disk 
systems. Be sure that the 
trailing backslash "\" is 
present) 


2.4.9 Macro File 


When you specify a macro file, it is automatically 
loaded when DRAFT is invoked. 


To select Macro File, type MF. A reverse video bar 
appears beside MF - Macro File. Type the path and 
filename of the macro file. Then, press <ENTER> 


Examples: 


(Looks for the macro file 
MF - Macro File A: on Drive A.) 
MACRO1.MAC 

(Looks for the macro file 
MF - Macro File on the hard disk in the 
MACRO1.MAC root directory that 


contains DRAFT.EXE.) 
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NOTE 


OrCAD supplies a couple of sample macro 
files called MACRO1.MAC and 
MACRO2.MAC, located on one of the 
MASTER SOFTWARE DISKS. Refer to the 
MACRO command in Section 4, for a 
description of this file. 


2.4.10 Initial Macro 


Initial Macro enables you to execute a specific macro 
automatically when DRAFT is invoked. For the Initial 
Macro to work, you must have previously loaded a 
macro file as outlined in Section 2.4.9 above. 


To select Initial Macro, type IM. A reverse video bar 
appears beside IM - Initial Macro. Type the ASCII 
character name of the macro you want to run. Then, 
press <ENTER>. 


For example, if you want to assign the F1 key to 
execute a macro, press the 'F" key, then the '1' key, 
followed by <ENTER>. 


If you want to assign Ctrl-A to execute a macro, type * 
(Shift 6), then A. Then, press <ENTER>. 


NOTE 


To execute an initial macro, the <ENTER> 
key must be the first key you press when 
creating the macro. The macro must also be 
saved and loaded as a macro file as outlined 
in Section 2.4.9 above. 
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Example: 


To create an initial macro (using the <F6> key) 
that turns on grid dots, the macro format is as 
follows. Refer to Section 4.11.12 for a discussion of 
macro formats. 


{F6}=(ENTER}sgvy{} 


2.4.11 Macro Buffer Size 


Macro Buffer Size enables you to modify the amount of 
memory allocated to the macro buffer, the storage 
location for the macros. The minimum memory size 
for the macro buffer is 16384 bytes; the maximum is 
65535. 


Type MB to change the macro buffer size. The prompt 
"Macro Buffer Size?" appears. Type the desired buffer 
size and press <ENTER>. The number must be in the 
range 16384 - 65535. 


2.4.12 Hierarchy Buffer Size 


Hierarchy Buffer Size enables you to modify the 
amount of memory allocated to the hierarchy buffer, 
used to store all hierarchical sheet and pathnames. The 
minimum memory size for this buffer is 1024 bytes, 
which enables you to create a hierarchical depth of 
about 75 - 100 worksheets (depending on sheet and 
pathname character lengths). You can increase the 
size of the hierarchy buffer to 65535 bytes, large 
enough for a hierarchical depth over 200 worksheets. 


Type HB to change the Hierarchy Buffer Size. The 
prompt “Hierarchy Buffer Size?" appears. Type the 
desired buffer size and press <ENTER>. The number 
must be in the range 1024 - 65535. 
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2.4.13 Color Table / Plotter Pen Table 


Color Table / Plotter Pen Table enables you to modify 
the screen display and plotter colors for library parts, 
pin numbers and names, wires, buses, junctions, 
connectors, and other objects in the worksheet. 


Type CT to display the color table / plotter pen table. 
Type M to display another screen of items that you can 
modify. Typing M once more returns you to the 
original screen. The table gives you the opportunity to 
modify the following parameters: 


Color select: 


Type C to change the color of an item. The prompt 
"Item ->" then appears. Type the number of the item 
you want.to modify followed by an <ENTER>. 


Then, the prompt "New Color ->" appears. From the 
color table right-hand column, enter the number of the 
desired color. 


Pen select: 


Type P to select a different pen. The prompt "Item ->" 
then appears. Type the number of the item that 
corresponds to the pen you want to modify. 


The prompt "Enter Pen Number (0 = PAUSH, 1..16 = 
AUTO, 99 = IGNORE)" then appears. Type the new 
pen number followed by an <ENTER>. 


If you enter 99, the plotter will not plot the object. If you 


enter 0 (zero), the plotter pauses, enabling you to 
change pens. 
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Example: 


To suppress the title block when plotting, type P. 
Then, type 26 <ENTER>. At the "Enter Pen 
Number (0 = PAUSE, 1..16 = AUTO, 99 = 
IGNORE) ->" prompt: type 99 followed by an 
<ENTER>. 


Velocity select: 


Type V to change the pen velocity. The prompt “Item - 
>" then appears. Type the number of the item whose 
pen velocity you want to change. 


The prompt "New Velocity ->" then appears. Type the 
new velocity. Refer to your plotter manual to correctly 
set this command, or leave it in the DEFAULT 
configuration. Once modified, entering a zero (0) will 
return the selected item to the DEFAULT condition. 


Example: 


To change the velocity of the pen used for 
drawing buses, type V. Then, type 15 <ENTER>. 
At the "New Velocity ->" prompt, type the value 
specified in your plotter user's manual followed by 
an <ENTER>. 


Pen Width select: 


Type W to change the pen width. The prompt “Item - 
>" then appears. Type the number of the item whose 
pen width you want to modify followed by an 
<ENTER>. 


Then, the prompt "Pen Width" appears. Type the new 


pen width followed by an <ENTER>. The units are in 
inches (.010 is a hundredth of an inch). 
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NOTE 


If you notice that buses or object fills, have 
white spaces when plotting, it may be 
necessary to change this setting. Correct 
setting in some cases, may only be 
determined by experimentation. 


Field Name select: 


To change the name of Part Fields 1 through 8, type F. 

The prompt "Item ->" then appears. Type the number 

of the item whose name you want to modify followed by 
an <ENTER>. 


The prompt "New Field Name ->" then appears. Type 
the new field name followed by an <ENTER>. This 
change will be reflected on the DRAFT Edit 
subcommand menu. 


Type Q to quit and return to the main configuration 
menu. 


Refer to "Four-Color Mode Configurations" in the 
Appendix for selecting colors on graphic boards in the 
four-color mode. 


2.4.14 Template Table 


Template Table enables you to modify the size of 
various fields in DRAFT schematics. This includes 
worksheet dimensions, text size, object sizes, borders, 
etc. The units are inches. 


For example, with DRAFT, you can have five possible 
sheet sizes: A though E. With the Template Table, you 
can specify the horizontal and vertical dimensions of 
each sheet size. 
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Be aware of what you are doing. For example, because 
pin numbers appear between pins, you don't want the 
pin number size to be greater than the pin-to-pin 
spacing. 


Type TT to display the Template Table. Type M to 
display another screen of items whose size that you can 
modify. Typing M once more returns you to the 
original screen. 


To change the size of a field, first choose which of the 
sheet sizes you want to modify. Type a letter from A to 
E. The prompt "Item ->" then appears. Type the 
number of the item whose size you want to modify 
followed by an <ENTER>. The prompt "New Value - 
>" then appears. Type the new value measured in 
inches followed by an <ENTER>. The Template Table 
reappears. Type Q to quit and return to the main 
configuration menu. 


The maximum setting for a worksheet dimension is 65 
inches by 65 inches, including the border. Object 
scaling is controlled by modifying the "Pin to Pin" field. 


2.4.15 Update Configuration Information 


After you update the configuration information, it is 
automatically loaded when you invoke DRAFT or the 
utilities. 

To update the configuration information, type U. Once 


the DRAFT configuration is updated, the main 
configuration menu remains on the screen. 
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CAUTION 


If you quit the program before updating the 
configuration information, all information is 
lost. 


2.4.16 Returning to DOS with Quit 


Quit enables you to return to DOS without updating the 
configuration information. 


Type Q to quit the program and abandon to DOS. If any 
changes were made to the configuration menu, the 
program first asks if you want to update the 
configuration information before returning to DOS. 


2.4.17 Run Program 
Run program enables you to invoke DRAFT with the 
latest configured information that appears on the 


configuration menu. 


Type R to invoke DRAFT or a utility program. 
2.4.18 Dual-Floppy Configuration Example 


Figure 2-7 below, shows OrCAD/SDT III configured for 
a dual-floppy system. 
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+2: CONFIGURATION OF OrCAD/SDT::: 


- Driver Prefix B: 
- Display Driver HGC2.DRV 
- Printer Driver LQ1000.DRV 
- Plotter Driver HP.DRV 
- Library Prefix B: 
- Library Files 
- ANALOG.LIB 
MOTO.LIB 
MEMORY.UB 
DEVICE.UB 
INTEL.LIB 
TTL.LIB 


- Worksheet Prefix B: 
- Macro Files MACRO1.MAC 
- Initial Macro 8192 
- Macro Buffer Size 1024 
- Hierarchy Buffer Size 
- Color Table/Plotter Pen Table 
- Template Table 
- Update Configuration Information 
- Quit, Abondon to DOS 
- Run Program 
Command? 


Figure 2-7. Sample Dual Floppy Configuration 


The driver and library prefixes in this example are 
configured for drive B, since the DRIVER/LIBRARY 
disk is placed in drive B before invoking DRAFT. The 
worksheet prefix is also configured for drive B. 


After invoking DRAFT, you must remove the 
DRIVER/LIBRARY disk from drive B at the "Load 
File?" prompt. Then, insert the SHEET disk in drive B, 
enabling DRAFT to load your worksheet files. 


NOTE 
You must configure the ORCADSDT.OVL 


file on the DRAFT 2 disk when you invoke it 
for the first time. 
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2.4.19 Sample Hard Disk Configuration 


Figure 2-8 shows OrCAD/SDT III configured for a 
hard disk system. 


>: CONFIGURATION OF OrCAD/SOT : : : 


- Driver Prefix DRIVER\ 
- Display Driver EGA16E.DRV 
- Printer Driver HPLASER4.DRV 
- Plotter Driver HI.DRV 
- Library Prefix LIBRARY\ 
- Library Files 

CMOS.LIB 

DEVICE.LIB 

MOTO.LIB 

INTEL.LIB 

MEMORY .UB 

ANALOG.LIB 


- Worksheet Prefix SHEET\ 

- Macro Files MACRO1.MAC 
- Initial Macro 8192 

- Macro Buffer Size 1024 

- Hierarchy Buffer Size 

- Color Table/Plotter Pen Table 

- Template Table 

- Update Configuration Information 

- Quit, Abondon to DOS 

- Run Program 


Command? 


Figure 2-8. Sample Hard Disk Configuration 


The driver, library, and worksheet prefixes have been 
configured as DRIVER\, LIBRARY\, and SHEET\ 
respectively. This corresponds to the like-named 
subdirectories you created within the ORCAD 
directory. 
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2.5 IF YOU HAVE CONFIGURATION PROBLEMS 


The most common configuration problem that you will 
likely encounter is: MSDOS Error # 2 File Not Found. 
If you see this error message, check for these 
conditions: 


1. Ifyou are using a hard disk, be sure that there is a 
back slash (\) 
after DRIVER\, LIBRARY\, and SHEET\ in 
their respective prefixes. 


2.  Ifyours is a dual-floppy system, be sure that you 
have specified B: for the driver, library, and 
worksheet drive prefixes. 


3. Besure that the filenames are actually present in 
the floppy directory or the hard disk subdirectory. 


Another common error is: MSDOS Error # 3 Path Not 
Found. If you see this error message, be sure that there 
are no blank spaces preceding or following the name of 
a text entry. 


For example, there should be no space preceding or 
following DRIVER\, TTL.LIB, or any other text entry. 
Re-enter any questionable entries. 


2.6 SEND IN YOUR REGISTRATION CARD 


Remember to send in your product registration card, 
located in the sealed packet that contained your 
OrCAD/SDT III program diskettes. Only by sending in 
your registration card do you become eligible for 
product updates and support. 
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SN. 3. GETTING STARTED 


In Section 1 you were introduced OrCAD/SDT III, 
presenting its major features. Section 2 showed you 
how to configure OrCAD/SDT III to run on your 
personal computer. 


In this section, you will: 


¢ Learn how to invoke DRAFT and execute keyboard 
and mouse commands. 


¢ Receive an overview of the functions that make 
OrCAD/SDT III easy to use: loading, saving, and 
printing worksheet files. 


¢ Be introduced to the three types of file structures 
used for creating your worksheets: flat file, 
hierarchy, and one-sheet file structures. 


For detailed command descriptions, refer to Section 4. 
If you are a first-time user, we recommend that you 
review the tutorial in Section 8, after you read this 
section. 


3.1 INVOKING DRAFT 


When you have configured DRAFT for the libraries, 
graphics board, printer, and plotter drivers, the 
program is ready to run. To invoke DRAFT, be sure 
that you are in the ORCAD directory if you are using a 
hard disk system. If you are using a dual floppy disk 
system, place the DRAFT disk that you created in 
Section 2 into drive A, and the DRIVER/LIBRARY disk 
into drive B. 
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Type the following at the DOS prompt: 
DRAFT <ENTER> 


After DRAFT loads the drivers and libraries, a screen 
appears displaying the OrCAD logo. At the top of the 
screen, "Type any key to continue” appears. Type any 
key to display the Copyright Notice screen. 


In a few seconds, "Type any key to continue" is repeated 
at the top of the screen. Typing any key displays: "Load 
File?” You now enter a filename, or begin a new 
worksheet as follows: 


e To begin a new worksheet, press <ENTER> when 
the "Load File?" prompt is displayed 


¢ To load a previously created worksheet, enter the 
filename and press <ENTER> 


3.2 COMMAND AND MENU ORGANIZATION 


DRAFT is an interactive, schematic capture program 
that uses pop-up command menus and prompts. The 
commands are further categorized into main 
command and subcommand menus. You can display 
both command menus on the screen by pressing 
<ENTER> or by using a mouse. Figure 3-1 illustrates 
the main command menu as it appears on the screen. 
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Block 
Conditions 


Figure 3-1. The Main Command Menu 


If you are at the main command menu (you have not 
yet executed a command) and you press <ENTER>, 
the main command menu is displayed on the screen. If 
you are at a subcommand menu (you have executed a 
command) and you press <ENTER>, the 
subcommand menu is displayed on the screen. A 
subcommand menu has its main command name 
displayed on the prompt line (see Figure 3-2). 


3.2.1. Invoking Commands 


You may execute commands in two ways. 


1. Press the first letter of the command name. It is 
not necessary for the command menu to be 
displayed on the screen. 


Ze Select the command or subcommand from the 


menu by moving the highlighted bar over it and 
pressing <ENTER>. 
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A subcommand menu is shown in Figure 3-2. Notice 
the word Place above the menu. This tells you that the 
Place command has been invoked, and you may select 
any of these subcommands: Wire, Bus, Junction, Entry 
(Bus), Label, Module Port, Power, Sheet, or Dashed line. 


Place 


Bus 
Junction 
Entry (Bus) 
Label 
Module Port 


Dashed Line 


Figure 3-2. The Place subcommand Menu 


Many of DRAFT's main commands have more than 
one level of subcommand. If you select the Wire 
subcommand (press W) from the Place subcommand 


menu for example, Figure 3-3 shows the 
subcommands that are displayed. 


Begin Find Jump Zoom escape 


Figure 3-3. The Wire Subcommands 


You execute one of these commands (shown on the 
prompt line) by pressing the first letter of the command 
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name, or by pressing <ENTER> to pull up the menu. 

-The prompt line displays subcommands or user 
messages. You may execute any of the PLACE Wire 
subcommands from the prompt line. 


To return to the command level or to abandon a 
command, press <ESCAPE>. 


3.3 CREATING A NEW WORKSHEET 


Within DRAFT, you may clear or create a new 
worksheet by selecting QUIT Initialize. 


Once selected (if there are objects placed in the 
worksheet), DRAFT returns "Are you sure?” on the 
subcommand menu. This reminds you not to 
accidentally clear the worksheet. Select [No] to 
abandon QUIT Initialize and return to the main 
command level. Select [Yes] to clear the worksheet. 


The new schematic worksheet created defaults to an 
"A" size worksheet. You may change the worksheet 
size by selecting "SET Worksheet Size”. 


3.4 LOADING WORKSHEET FILES 


There are several ways to load a previously saved 
worksheet into DRAFT. You may load a worksheet 
from DOS, or after you have invoked DRAFT. You 
may also load a worksheet from within the program 
editing session. The methods for loading a worksheet 
file are outlined below. 
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3.4.1 From DOS 


From DOS you may load a worksheet when invoking 
DRAFT by typing: 


DRAFT filename <ENTER> 


Where filename is the filename of a worksheet to be 
loaded. 


After DRAFT loads drivers and libraries, a screen 
appears displaying the OrCAD logo. At the top of the 
screen, the message "Type any key to continue” 
appears. Press any key to display the Copyright Notice 
screen. 


In a few seconds, "type any key to continue” repeats at 
the top of the screen. When you type any key, the 
filename you specified on the DOS command line is 
loaded. 


3.4.2 After Invoking DRAFT 


You may load a worksheet after invoking DRAFT by 
typing: 


DRAFT <ENTER> 


After DRAFT loads drivers and libraries, a screen 
appears displaying the OrCAD logo. At the top of the 
screen, the message "Type in any key to continue" 
appears. Press any key to display the Copyright Notice 
screen. 


In a few seconds, "type any key to continue" is repeated 
at the top of the screen. When you press any key, the 
message "Load File?" is displayed. You may now enter 
a filename, or begin a new worksheet as follows: 
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To load a previously created worksheet, enter the 
filename and press <ENTER>. To begin a new 
worksheet, press <ENTER> when the "Load File?" 
* prompt is displayed. 


3.4.3 From Within DRAFT 


To load a worksheet from within DRAFT, select QUIT 
Initialize. If there are are objects placed in the 
worksheet, DRAFT returns "Are you sure?” on the 
subcommand menu. This reminds you not to 
accidentally clear the worksheet. Select [No] to 
abandon QUIT Initialize and return to the main 
command level. Select [Yes] to clear the worksheet and 
load another worksheet file. 


With a clear worksheet, DRAFT returns "Load File?" 
on the prompt line. Type in the path and the filename 
that you wish to load and press <ENTER>. If the 
filename exists, the worksheet is loaded and displayed 
on the screen. If the filename does not exist, <<<new 
worksheet>>> appears on the prompt line. 


3.5 SAVING WORKSHEETS TO A FILE 


The QUIT Write command enables you to save the 
current worksheet to any file you specify. When you 
invoke QUIT Write, DRAFT returns "Write to File?" on 
the prompt line. 


Type the desired path and filename, then press 


<ENTER>. The worksheet is saved to the file specified 
and DRAFT returns to the Quit subcommand menu. 
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3.6 UPDATING FILES 


The QUIT Update command updates the current 
version of the worksheet. If the current worksheet had 
been previously loaded from a file, that file is updated. 


If the current worksheet is unnamed, DRAFT responds 
with "Write to File?" on the prompt line. Type in a 
filename and press <ENTER>. 


3.7 EXITING DRAFT 


To exit DRAFT and return to DOS without saving 
changes, select the "QUIT Abandon" command. If 
objects have been placed in the worksheet since the last 
update, DRAFT returns "Are you sure?" on the 
subcommand menu. Select [No] to abandon the 
subcommand. Select [Yes] to quit DRAFT without 
saving changes and return to the operating system. 


3.8 PRINTING A FILE 


To print a worksheet, use HARDCOPY. If you prefer to 
print from DOS, use the PRINTALL utility. 


To print, select HARDCOPY. Be sure that the 
"HARDCOPY Destination" you select is "LPT", then 
choose the appropriate paper width using the 
HARDCOPY Width of Paper command. To print, 
select the HARDCOPY Make Hardcopy command. 


Output resolution depends on which printer driver you 
have configured. For example, there are four HP 
LaserJet printer drivers available with OrCAD/SDT III 
(75, 100, 150, and 300 dpi). If you have the 150 dpi 
driver configured, then the output resolution is 150 dots 
per inch. 
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For additional information, refer to the HARDCOPY 

‘command outlined in Section 4, the PRINTALL utility 
in Section 6, and Section 2.4 for configuration 

~ information. 


3.9 PLOTTING A FILE 


The PLOTALL utility plots your files. Refer to Section 6 
for information on the PLOTALL utility. 


3.10 USING A MOUSE 


When you use a mouse, commands and subcommands 
are entered with the left and right mouse buttons. The 
left is the <ENTER> button and the right <ESCAPE>. 
If your mouse has three buttons, the middle button is 
unused and may be defined as a command macro key. 


From the main command level, execute a command 
with the mouse by pressing <ENTER> (left button). 
This displays the menu on the screen. Move the 
highlighted bar to the desired command and press 
<ENTER> again to execute the command. Repeat this 
procedure to execute commands. 


The DRAFT Again command, was designed for use 
with the mouse. It enables you to repeat the previous 
main level command without scrolling through the 
menu to find it. 
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NOTE 


Version 5.00 of the Mouse Systems (IMSI) 
mouse driver has a bug that causes the 
cursor movement in the Y-axis to be 
opposite of what is expected. Prior versions 
and subsequent revisions do not have this 
problem. If you have Version 5.00 of the 
Mouse Systems driver, contact Mouse 
Systems for an update. 


3.11 WORKSHEET FILE STRUCTURES 


Design organization is an integral part of the schematic 
design process. Typically, a design moves through the 
refinement of general concepts to a final set of detailed 
schematic diagrams. With OrCAD/SDT III, schematic 
worksheets may be created using three different file 
structures. The file structures are: 


e Flat File 
¢ Hierarchy File 
¢ One-Sheet 


Typically, you will select the file structure for creating 
your schematic worksheet that best suits the 
complexity of your design. We recommended that you 
become familiar with all three file structures. The file 
structure you select determines how you use module 
ports (graphic objects used to represent signal 
connections between worksheets) and labels in the 
worksheet, and furthermore, how you invoke 
OrCAD/SDT III's utility programs. 


Your introduction to worksheet file structures begins by 


examining a flat file structure. Discussions of the 
hierarchical and one-sheet file structures follow. 
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Further information on using each file structure is 
found in Section 5 (Hierarchy), Section 6 (NETLIST 
_ Utility), and Section 8 (Tutorial). 


3.11.1 The Flat File Structure 


The flat file structure, traditional method for 
organizing schematic sheets, can be used for simple or 
complex designs. This file structure can be thought of a 
collection of single worksheets with signals connected 
one worksheet to another through the use of module 
ports (graphic objects used for connections between 
worksheets). 


Internally, the worksheet contains parts, wires, buses, 
labels, junctions, and other objects. You simply create a 
flat file structure by assigning a separate filename to 
each schematic worksheet in your design, then connect 
inter-sheet signals through the module ports. 


An example of a typical flat file structure is illustrated 
in Figure 3-4 below. 
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CPUsSCch 


IY (CS). Sel 


<8 [Om yas 13 


MEMORY .SCH 


Figure 3-4. Flat File Structure 


In this example, you see three separate worksheets 
with unique filenames: CPU.SCH, I/O.SCH, and 
MEMORY.SCH. 


Signals (wires and buses) are connected one worksheet 
to another through identically named module ports. 
A[0..7] from the CPU.SCH worksheet is connected only 
to A[0..7] on the I/O.SCH worksheet. Likewise, the XYZ 
and B[0..15] module ports connect the CPU.SCH and 
MEMORY.SCH worksheets together. Finally, C[0..3] 
connects signal from the I/O.SCH and MEMORY.SCH 
worksheets together. 
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For more information on module ports, refer to the 
“PLACE Module Port command in Section 4. 


3.11.2 The Hierarchy File Structure 


While a flat file structure is easy to understand and use, 
keeping track of module ports and managing utility 
programs can be difficult when your design is large or 
complex. 


Creating your worksheets in a hierarchical fashion is 
an easier way to organize a complex design. A 
hierarchical design has its individual worksheets 
organized in blocks, wheve each block contains part of 
the design. A block may have a block within it, 
containing progressively more detail. In addition, 
hierarchical blocks may be used over and over to 
replicate common circuit functions. 


The flat file structure of Figure 3-4 is shown modified 
into a hierarchical file structure in Figure 3-5 below. 
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Figure 3-5. Hierarchy File Structure; 
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In a hierarchical file structure, there is one "root" 
worksheet. In this example, the root worksheet has the 
_ filename COMPUTER.SCH. Using the PLACE Sheet 
command, you place individual blocks (named CPU, 
I/O, and MEMORY) in the root worksheet. These 
blocks are called "sheet symbols", and they represent 
separate unique worksheets. 


To display each sheet symbol as a worksheet, you place 
the cursor inside the sheet symbol boundary and 
execute QUIT Enter Sheet. This moves you one level 
down in the hierarchy. 


If you enter the MEMORY sheet symbol for example, 
the worksheet represented by the MEMORY sheet 
symbol would appear on the screen. With OrCAD/SDT 
III, you can create a hierarchical structure of well over 
200 levels. 


In the figure, connections between sheet symbols are 
made through "nets" placed along the borders of the 
sheet symbol. These nets are placed in the sheet symbol 
with the PLACE Sheet "add" subcommand. Ina 
hierarchy, "nets" in the sheet symbols make "implied" 
connections to similarly named module ports that are 
placed in the actual worksheet. 


The nets, named XYZ, A[0..7], B[0..15], and C[0..3] in 
Figure 3-5, connect the CPU, I/O, and MEMORY sheet 
symbols together. Once you "enter" a sheet symbol to 
get to the corresponding worksheet, module ports are 
used to connect signals that leave the worksheet. These 
module ports make the implied connection to the 
similarly named nets, located in the sheet symbol. For 
example, the XYZ net in the CPU sheet symbol (Figure 
3-5), would connect to a module port named XYZ (not 
illustrated) located in the actual CPU worksheet. 


For more information on hierarchical file structures, 
refer to Section 5. 
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3.11.3 The One-Sheet File Structure 


As the name implies, a one-sheet file structure is a 
design that is contained within one worksheet. Even 
though they are allowed, a one-sheet file structure 
design uses no module ports; since all signals remain 
within the worksheet. One sheet file structures may be 
handled as either flat or hierarchy file structures when 
you invoke the post-processing utility programs. 
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This section describes the OrCAD/SDT III commands 
in the order they appear on the main command menu. 
Certain concepts, described below, are used repeatedly 
in different commands. Refer to Section 3.1 fora 
review of command execution procedures. 


Cursor Movement: 


You may use the cursor control keys or a mouse to 
move the cursor on the screen. 


Defining an Area: 


For many OrCAD/SDT III commands to work, you 
must define an area on the worksheet where you want 
these commands to have an effect. Commands that 
ask you to define a worksheet area are: BLOCK Move, 
BLOCK Drag, BLOCK Save, BLOCK Export, DELETE 
Block, and PLACE Sheet. When you select one of these 
commands, DRAFT prompts: 


Begin Find Jump Zoom escape 
You define an area by drawing a box. Place the cursor 


where you want the corner of the box to begin (point A 
in Figure 4-1 below). 


4-1 


Commands Schematic Design Tools 


Delete 


Figure 4-1. Placing the Cursor at a Begin Point 


Select Begin. On the prompt line, DRAFT returns: 
End Find Jump Zoom_ escape 


As you move the cursor, a box is drawn that surrounds 
an area on the worksheet (refer to Figure 4-2 below). 
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End FAlnd Jump Zoom escape 


Figure 4-2. Drawing the Box 


When you complete the box, select End. The area is 
now defined, as Figure 4-3 shows. Once the area is 


defined, you may proceed with the command that was 
originally selected. 
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End Find Jump Zoom escape 


Figure 4-3. The Cursor Placed at the End Point 


NOTE 
The shape that defines an area may bea 
point, horizontal line, vertical line, or 
rectangle. 


Locating Objects 


To locate an object or a specific area on a worksheet, use 
these subcommands: 


To search for a string of 
Find: characters. Refer to 
Section 4.6. 
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To quickly move toa 
Jump: specific location. Refer to 
Section 4.9. 


To change the worksheet 
Zoom: scale. Refer to Section 4.17. 


Other concepts are: 


Library parts, wires, buses, 

Objects: junctions, labels, sheet 
symbols, module ports, 
power objects, etc. 


<RUBOUT> is the backspace key, and erases text. 


Press <ESCAPE> to abandon a command or 
subcommand. This command returns you to the main 
command or previous subcommand level. 
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4.1 AGAIN 


Again repeats the previously executed main level 
command. For example, if you previously selected 


PLACE, you may repeat PLACE with the AGAIN 
command. 
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4.2 BLOCK 


BLOCK and its subcommands enable you to 
manipulate specific areas of your worksheet. With the 
BLOCK subcommands Import and Export, you may 
also import previously saved files into your worksheet 
or write an area of your worksheet to a file. 


Select BLOCK to move, rubberband, make orthogonal, 
replicate, import, or export a section of a worksheet. 
DRAFT returns this subcommand menu: 


Move 
Drag 
Fixup 
Save 
Get 
Import 
Export 


4.2.1 BLOCK Move 


To move an object or area of the worksheet, first define 
the area that you want to move: select Begin, surround 
the area, then select End. 


When the area is defined Draft returns: 
Place Find Jump Zoom Escape 


Objects enclosed and intersected by the surrounding 
area may now be moved. The objects are then 
converted to outlined symbol shapes that enable them to 
move quickly around the screen. If you select an area 
containing many objects, only the box that defines the 
area appears to move. 


Move the area you have selected to the desired location. 
Note that objects within the area being moved still 
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remain at their original location. Only the outline 
symbols within the selected area move on the screen. 


To place the moved objects in the new worksheet 
location, select Place. The screen is redrawn, placing 
the objects. 


NOTE 


You may move and place a single object by 
positioning the cursor inside the object, then 
subsequently selecting Begin and End. Itis 
not necessary to enclose the object in a box. 
Move and place the object as described 
above. 


4.2.2 BLOCK Drag 


BLOCK Drag moves objects while maintaining 
connectivity for rubberbanding wires and buses. 


To drag a bus, you must enable the SET Drag Buses 
option (described in Section 4.15.3) to maintain bus 
connectivity. 


BLOCK Drag executes the same as BLOCK Move. 


4.2.3. BLOCK Fixup 

BLOCK Fixup enables you to "fix up” wires and buses, 
making them orthogonal by adding new segments. 
When you select Fixup, DRAFT returns this 
subcommand menu: 


Pick Find Jump Zoom _ escape 
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To select Fixup, place the cursor on either end of 
(touching) the wire, bus, or node that you want to make 

- orthogonal. Select Pick to attach the cursor. DRAFT 
returns this subcommand menu: 


Drop End Find Jump Zoom escape 


DRAFT displays a new conductor segment at the tip of 
the cursor when you move the cursor controls or 
mouse. Select Drop to attach the new conductor 
segment where you want it. 


Select End when you have finished Fixup. DRAFT 
returns you to the "Pick Find Jump Zoom escape" 
menu, enabling you fixup another wire or bus. 
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NOTES 


If a node has more than one wire or bus 
connected, a menu enables you to select 
either Drag All or Pick One wire or bus. 


Drag All enables you to drag all the wires or 
buses attached to a common node. 


Pick One enables you to choose one wire or 
bus for fixup from those connected to a 
common node. When you select Pick One, 
DRAFT returns this subcommand menu: 


Next 
Previous 
This 


The wire or bus you select with Pick One is 
displayed in phantom (dashed lines). Next 
selects the next wire or bus for fixup. 


Previous selects the previous wire or bus for 
fixup. Select This to fix up the wire or bus 
that you have selected (dashed lines). 


Use Fixup for straightening non-orthogonal 
wires and buses by adding segments to 
them. Clean-up applications that do not 
need segments added should be done with 
BLOCK Drag. 
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4.2.4 BLOCK Save 


BLOCK Save stores a group of objects for replication in 
another area of theworksheet. Use the procedure in 
Section 4.0 to define the area you want tosave. 


When you select End after defining a worksheet area, 
the objects within the area you have defined are saved 
in memory and DRAFT returns to the main command 
level. Objects that you have saved may be recalled to 
the screen with the BLOCK Get subcommand. 


NOTE 


The buffer used to save objects is also used by 
BLOCK Move and BLOCK Drag. Objects 
saved with a BLOCK Save will be lost after a 
following BLOCK Move or BLOCK Drag is 
executed. 


If you want to save objects and still use 
BLOCK Move or BLOCK Drag in your 
editing session, use BLOCK Export (refer to 
the BLOCK Export explanation) rather 
than BLOCK Save to store worksheet 
objects. 


4.2.5 BLOCK Get 
BLOCK Get retrieves objects that were saved via 
BLOCK Save. When you select BLOCK Get to retrieve 
objects stored in memory, DRAFT returns: 

Place Find Jump Zoom escape 
You will see a box containing the previously saved area 


with the cursor attached to its end. 
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Move the box to the desired worksheet location. Place 
the objects on the worksheet with the Place 
subcommand. 


You may continue to place saved objects with BLOCK 
Get, or press <ESCAPE> to return to the main 
command menu. 


4.2.6 BLOCK Import 


With BLOCK Import you may retrieve objects stored in 
other files and place them in your current worksheet. 
To retrieve the contents of another file, select BLOCK 
Import. DRAFT returns: 


File to Import? 


Type the path and filename of the file you want to 
import and press <ENTER>. DRAFT returns: 


Place Find Jump Zoom escape 


Position the cursor on the worksheet where you want 
to place the contents of a file. Select Place to place the 
contents of the imported file on the worksheet. The 
imported objects are placed on the worksheet with the 
cursor in the upper left corner of the imported area. 


4.2.7 BLOCK Export 


With BLOCK Export you can save a defined worksheet 
area to a file. To export an object or worksheet area, 


define the area that you want to export (refer to Section 
4.0, Defining an Area). 


After you have defined the worksheet area, select 
BLOCK Export. Draft returns: 


Export file name? 
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Type the path and filename for the worksheet area you 
want to export and press <ENTER>. Objects enclosed 


and intersected by the outlined area are saved to the file 
you specified. 
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4.3. CONDITIONS 


Conditions enables you to monitor your personal 
computer memory, and the memory available for these 
items: 


¢ Worksheet 
e Hierarchy buffer 
e Macro buffer 


Conditions has no subcommands. You may use the 
highlighted bar in the status menu as an aid in reading 
the table. To return to the main command level press 
either <ESCAPE> or <ENTER>. 


What you see in the pop-up Conditions is described 
below. 
4.3.1 Worksheet Memory Size 


Shows worksheet memory size, in bytes, when 
Conditions was invoked. Tells you how much memory 
your worksheet uses, and about how much disk space 
will be needed to save it. 


NOTE 
A worksheet uses memory space, even if it is 


blank, to hold frame and title block 
information. 
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4.3.2 Free Hierarchy Buffer 


Shows how much memory is available in the hierarchy 
buffer. The hierarchy buffer keeps track of sheet 
names when you move through a worksheet 
hierarchy. 


4.3.3 Free Macro Buffer 


Shows the memory available in the macro buffer. 
Macros created on-line or loaded into the system from 
a macro file are stored in the macro buffer. If user- 
created macros become too large, the macro buffer is 
unable to store them. Refer to Section 2.4.11 to increase 
the size of the macro buffer. Refer to Section 4.11 fora 
description of macros. 


4.3.4 Free System Memory 


Shows how much memory remains in your Personal 
Computer. 
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4.4 DELETE 


DELETE enables you to delete objects or blocks of 
objects. When you invoke DELETE, DRAFT returns a 
menu where you can select one of these subcommands: 


¢ Object 
¢ Block 
¢ Undo 


4.4.1 DELETE Object 


As the name implies, you use DELETE Object to delete 
an object from the worksheet. 


Select DELETE Object. On the prompt line, DRAFT 
returns: 


Delete Find Jump Zoom escape 


Place the cursor on the object you want to delete (you 
may use Find, Jump, and Zoom to help locate objects on 
the worksheet) and select the Delete subcommand. 


If you want to delete one of two intersecting wires and 
you have placed the cursor at their intersection, the 
first wire drawn will be the first deleted. To delete the 
last wire drawn, move the cursor away from the 
intersection along the wire you want to delete and 
delete it. 


If the cursor is pointing to more than one object, 
DRAFT returns: 


Delete which Object? 
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DRAFT displays a menu listing objects to delete. Select 
the object from the menu to delete it. 


NOTE 


You must place the cursor within the body of 
the part to delete it. 


When you have deleted an item from the worksheet, 
DRAFT returns you to the Delete subcommand level, 
where you may continue to delete objects. 


To return to the main command level and redraw the 
worksheet, press <ESCAPE>. 


4.4.2 DELETE Block 


Use DELETE Block to delete a worksheet area. To 
delete an area of the worksheet, define the area (refer 
to Section 4.0 to Define an Area. 


When you finish defining the area, objects within and 
intersected by the outlined area are deleted when you 
execute the End subcommand. Once the block of 
objects are deleted, DRAFT returns you to the main 
command level. 


4.4.3 DELETE Undo 
You may restore accidentally deleted objects to the 
worksheet with DELETE Undo. This command 


restores objects deleted with the last execution of the 
Delete command. 
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With the EDIT command, you can do the following: 

Le Edit the title block, module ports, labels, power 
objects, sheet symbols, part reference designators, 
part names and fields. 


2. Select different pinouts on devices with multiple 
parts per package. 


3. Movea part reference designator and name to 
other locations. 


4. Choose to make the part reference designator, the 
part value or both invisible. 


When you invoke EDIT, DRAFT returns the menu: 
Edit Find Jump Zoom escape 

Move the cursor to what you want to edit and select 

Edit. 

4.5.1 Editing Labels 


To edit a label, place the cursor under the label name 
and select Edit. DRAFT returns the menu: 


Name Orientation Larger Smaller 


Select Name to edit the name of a label. When you 
select Name, the prompt "Name?" appears followed by 
the current label name. Use <RUBOUTS> (the 
Backspace key) to erase it. Type the new name 
followed by an <ENTER>. 


Select Orientation to change the orientation of the label 
to Horizontal or Vertical. 
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Select Larger to make the label larger and Smaller to 
make it smaller. 


4.5.2 Editing Module Ports 


To edit a module port, place the cursor within the 
module port symbol and select Edit. A menu displays 
these subcommands: 


Name Type Style 


Select Name to edit a module port name. When Name 
is invoked, the module port name appears on the 
prompt line after "Module Port Name?" followed by the 
current module port name. Use <RUBOUT?> to erase 
the name. Then, type the new name followed by an 
<ENTER>. 


Select Type to change the type of module port. Module 
port choices are Input, Output, Bidirectional, or 
Unspecified. 

Select Style to change the style of a module port. 
Possible styles are Right pointing, Left pointing, Both 
pointing, and Neither pointing. 


Press <ESCAPE> to abandon editing a module port. 
DRAFT returns to the Edit menu. 


For information about placing module ports on the 
worksheet, refer to 4.12.7, PLACE Module Port. 


4.5.3 Editing Power Objects 


To edit a power object, place the cursor on the power 
object and invoke Edit. DRAFT returns the menu: 


Name Type Orientation 
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Select Name to edit the name of the power object. 

When you invoke Name, the name of the power object 
appears on the prompt line after "Power Name?" 
followed by the current power name. Use 

<RUBOUT> to erase the current name. Then type the 
new name followed by an <ENTER>. 


Select Type to change the type of power object. The 
choices are Circle, Arrow, Bar, or Wave. 


Select Orientation to change the orientation to top, 
bottom, left, or right. 


For information about placing power objects on the 
worksheet, refer to 4.12.8, PLACE Power. 


4.5.4 Editing Sheets 


To edit hierarchical sheet symbols, place the cursor 
within the sheet symbol boundary and select Edit (use 
Find, Jump, or Zoom to locate the sheets you want to 
edit). 


When you invoke Edit, cursor movement is restricted 
to the border of the sheet symbol. This helps you place 
the cursor at sheet net name locations. When Edit is 
invoked, DRAFT returns the menu: 


Add Delete Edit Name Filename Size Zoom 
escape 


Use Add to add net connections between worksheets. 
To add a net name, place the cursor at the edge of the 
box where you want to place the net name Then, select 
Add. 


DRAFT returns the prompt "Net Name?." Type the 


desired net name and press <ENTER>. A menu 
displays input, output, bidirectional, and unspecified net 
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names. Select the kind of net name you want and press 
<ENTER> to place it on the worksheet. 


To delete a net name, place the cursor on the net name 
and select Delete. 


To edit a net name, place the cursor on the net name 
and select Edit. When the net name appears on the 
prompt line, press <RUBOUT> to erase it. Type the 
new net name and press <ENTER> to enter it on the 
worksheet. 


Name is used to edit the name of a sheet symbol, located 
at the top of the sheet. The initial sheet name is a 
question mark (?). Typically, such names as "Memory 
Array" or "Dynamic RAM Refresh Circuitry" are used 
to identify the function of the worksheet represented by 
the sheet symbol. 


To edit the name of the sheet symbol, select Name. 
DRAFT returns the prompt "Sheet name?" and shows 
the name on the prompt line. Press <RUBOUT> to 
erase the old name. Type the new name on the prompt 
line and press <ENTER3> to place it at the top of the 
sheet. 


Press <ESCAPE> if you want to abandon any changes 
made to the sheet name. Filename enables you to edit 
the name of the file that contains a worksheet 
represented by a sheet symbol. 


DRAFT automatically generates a filename based on 
the date and time of day, ensuring that no two 
filenames will be alike. The filename generated by 
DRAFT appears on the prompt line when you invoke 
Filename. 


If you want to edit the filename, select Filename. 


DRAFT returns the prompt "file name?" followed by the 
current filename. Press <RUBOUT> enough times to 
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erase the old filename. Type a new file name and press 
<ENTER> to enter it on the worksheet. 


Press <ESCAPE> to abandon any changes made to the 
filename. 


Select Size to change the size of the worksheet displayed 
on the screen. DRAFT returns the menu: 


End Jump Zoom _ escape 


DRAFT places the cursor on the lower right corner of 
the worksheet. To change worksheet size, move the 
cursor until you reach the desired size, then select End. 


For more information about worksheet sizes, refer to 
4.12.8 Place Sheet, and Section 5, Hierarchy. 


4.5.5 Editing Parts 


Edit Parts enables you to edit and move part reference 
designators, values, and fields. It also enables you to 
select other packages on library parts with multiple 
parts per package and change the orientation of the 
symbol. Figure 4-4 illustrates a library part with its 
default reference designator and part value. 


Wigys\ <> nls (sary 
REeBeReNGe 
DESIGNATOR 


A013 ses HE PAR VAEVE 


Figure 4-4. A CMOS 4013 Library Part with its 
Default Reference Designator and Part Value 
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To edit a part, place the cursor within the part symbol 
boundary and select Edit. For a description of a symbol 
boundary refer to 4.7.1, The Outline Symbol. 


‘When you select Edit, DRAFT returns the menu: 


Reference 
Part Value 
Part Field 1 
Part Field 2 
Part Field 3 
Part Field 4 
Part Field 5 
Part Field 6 
Part Field 7 
Part Field 8 
Orientation 
Which Device? 


"Which Device?" only appears when you edit a device 
with multiple parts per package. 


Reference 


Select Reference to edit or move the reference 
designator values of library parts placed on the 
worksheet. Typical examples of reference designators 
are: U1, U2A, Q6, R1, R2, and C12. 


When you select Reference, DRAFT returns the menu: 
Name Location Visible 


Select Name to edit the name of a reference designator. 
The prompt "Reference?" appears. If the part already 
has a reference designator name assigned, it also 
appears on the prompt line. Press <RUBOUT> 
enough times to erase any old reference designator. 
Then, type the new reference designator on the prompt 
line and press <ENTER> to place it on the worksheet. 
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Select Location to change the reference designator's 
location. DRAFT highlights the reference and part 
value designators and returns the menu: 


Place Find Jump Zoom _ escape 


You may move the reference designator anywhere in 
the worksheet using the cursor keys or mouse. Select 
Place to place the reference designator in the new 
worksheet location. 


Refer to the utility Annotate (discussed in Section 6) for 
a method of automatically incrementing reference 
designators and changing the corresponding pin 
numbers of parts placed on the worksheet. 


Select Visible to choose whether the reference 
designator appears on the screen or on hardcopy. 
When you select Visible, DRAFT lets you choose 
between [Yes] and [NO]. Yes makes the reference 
designator visible; No makes it invisible. The Visible 
command controls the visibility of reference 
designators at all Zoom scales. 


Part Value 


Select Part Value to edit or move the part values of 
components on the worksheet. Typical examples of 
part values are: 100K, 1N4004, .01 uf, 2N2222, and 
80386. 


When you select Part Value, DRAFT returns the 
menu: 


Name Location Visibility 


Select Name to edit the name of a part value. The 
prompt "Value?" appears. Ifthe part already has a 
value assigned, it also appears on the prompt line. 
Press <RUBOUT> enough times to erase any old part 


4-24 


Schematic Design Tools . EDIT 


value. Then, type the new part value on the prompt 
line and press <ENTER> to place it on the worksheet. 


_ Select Location to change the part value's location. 
DRAFT highlights the reference and part value 
designators and returns the menu: 


Place Find Jump Zoom _ escape 


You may move the part value anywhere in the 
worksheet using the cursor keys or mouse. Select Place 
to place the part value in the new worksheet location. 


Select Visible to choose whether the part value appears 
on the screen or on hardcopy. When you select Visible, 
DRAFT lets you choose between Yes and No. Yes 
makes the part value visible; No makes it invisible. The 
Visible command controls the visibility of part values at 
all Zoom scales. 


NOTE 


If the token REFERENCE is used in library 
source files, the library part name is inserted 
in place of the part value when parts are 
placed in the worksheet. This may be edited 
to enter the actual part value. 


Part Fields 


Eight part fields may be placed on the schematic 
worksheet by selecting them from the menu. Part 
fields may be used to add any additional information 
about the part, in the schematic. For example, 
tolerance, part number, vendor information, etc., may 


be added. 
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When you select a Part Fields, DRAFT returns the 
menu: 


Name _ Location 


Select Name to edit the name of a part field. The 
prompt "Part Field?" appears. Ifthe part already has a 
name assigned, it also appears on the prompt line. 
Press <RUBOUT> enough times to erase any old part 
field. Then, type the new part field name on the prompt 
line and press <ENTER> to place it on the worksheet. 


Select Location to change the part field's location. 
DRAFT highlights the designators and returns the 
menu: 

Place Find Jump Zoom escape 
You may move the part field anywhere in the 
worksheet using the cursor keys or mouse. Select Place 
to place the part field in the new worksheet location. 


Orientation 


To reposition a part, select Orientation. DRAFT 
returns the menu: 


Rotate Convert Normal Up Over Down Mirror 
Zoom escape. 


Rotate 

The Rotate command rotates the part 90 degrees 
counterclockwise from its current position. 
Convert 


The Convert command is displayed when editing a part 
having another representation of the same part. For 
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example, you may change a 74LS02, normally 
represented as a NOR gate, to its DeMorgan 
representation with Convert. 


Normal 

The Normal command returns a rotated part to its 
original position, as created in the part library. Normal 
also returns parts to a normal position that have been 
converted to other shapes with the Convert and Mirror 
commands. 

Up 

The Up command rotates a part once, 90 degrees 
counterclockwise, from its normal position. 

Over 

The Over command rotates a part 180 degrees 
counterclockwise, equivalent to rotating it twice from 
its normal position. 

Down 

The Down command rotates a part 270 degrees 
counterclockwise, equivalent to rotating it three times 
from its normal position. 


Mirror 


The Mirror command gives a mirror-image of a part. 
Mirroring is along the horizontal axis. 
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Which Device 


Which Device only appears when you edit a part that 
contains more than one part per package. An example 
would be a 74LS04 hex inverter. This part contains six 
inverters. You may select a different part in the 
package by selecting Which Device. Then, select the 
number that represents the device in the package you 
desire. 


4.5.6 Editing the Title Block 


To edit title block information, place the cursor inside © 
the title block and select Edit. The title block is in the 
lower right worksheet corner. The title block 
information that you add or edit goes to a holding 
buffer, appearing in the title block on screen after you 
press <ESCAPE> to end the title block edit. 


When you select Edit, DRAFT returns the menu: 


Revision code 

Title of sheet 
Document number 
Sheet number 
Number of sheet 
Organization name 
1st Address Line 
2nd Address Line 
3rd Address Line 
4th Address Line 


Revision Code 


Select Revision Code to add or edit the revision code. 
DRAFT returns the prompt "Revision Code?” 


Type the desired revision number (three characters 


maximum). If you are editing an existing revision 
code, press <RUBOUT> enough times to erase the 
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current revision code. Then, type the new revision code 
on the prompt line. Press <ENTER> to place it in the 
holding buffer. 


When you have finished editing the revision code, press 
<ESCAPE> to update the title block. 


Title of Sheet 


Select Title of Sheet to add or edit a title (44 characters 
maximum). DRAFT returns the prompt "Title of 
Sheet?" 


Type the desired sheet title. If you are editing an 
existing worksheet title, press <RUBOUT> enough 
times to erase the current title. Then, type the new title 
on the prompt line. Press <ENTER> to place it in the 
holding buffer. 


When you have finished editing the sheet title, press 
<ESCAPE> to update the title block. 


Document Number 


Select Document Number to edit or add a document 
number (36 characters maximum). DRAFT returns 
the prompt "Document Number?" 


Type the document number. If you are editing an 
existing document number, press <RUBOUT> enough 
times to erase the current number. Then, type the new 
document number on the prompt line. Press 
<ENTER> to place it in the holding buffer. 


When you have finished editing the document number, 
press <ESCAPE> to update the title block. 
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Sheet Number 


Select Sheet Number to add or edit a sheet number (any 
number up to 32767). DRAFT returns the prompt 
"Sheet Number?" 


Type the sheet number. If you are editing an existing 
sheet number, press <RUBOUT> enough times to 
erase then current number. Then, type a new sheet 
number on the prompt line. Press <ENTER> to place 
the new sheet number in the holding buffer. 


When you have finished editing the sheet number, 
press <ESCAPE> to update the title block. 


Number of Sheet 


Select Number of sheets to add to the number of 
worksheets (any number up to 32767). DRAFT 
returns the prompt "Number of Sheets?” 


Type the desired number of sheets. If you are editing 
an existing number of sheets, press <RUBOUT> to 
erase the current number. Then, type the new number 
of sheets on the prompt line. Press <ENTER> to place 
the number of worksheets information in the holding 
buffer. 


When you have finished editing the number of 
worksheets, press <ESCAPE> to update the title block. 
Organization Name 

Select Organization Name to add or edit an 
organization name (up to 44 characters). DRAFT 


returns the prompt "Organization Name?" 


Type the desired name. If you are editing an existing 
organization name, press <RUBOUT> enough times 


4-30 


Schematic Design Tools EDIT 


to erase the name. Then, type the new organization 
name on the prompt line. Press <ENTER> to place it 
_ in the holding buffer. 


When you have finished editing the organization name, 
press <ESCAPE> to update the title block. 


Address Lines 


Select the address line you want to edit. Each line can 
be up to 44 characters long. DRAFT returns the 
prompt "Address Line?" 


Type the desired address. If you are editing an existing 
address line, press <RUBOUT> enough times to erase 
the current line. Then, type the new address on the 
prompt line. Press <ENTER> to place it in the holding 
buffer. 


When you have finished editing the address, press 
<ESCAPE> to update the title block. 

Size 

To change the size field of the title block, use the SET 
command to change the worksheet size. 

Date 

When you create a worksheet, the current date is 
automatically placed in the title block and is updated 


when you make changes. The date is taken from the 
personal computers current clock setting. 
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Revision History 


You may want to add a revision history to the top of the 
title block. Use the PLACE Wire command to draw a 


revision history box and the PLACE Text command to 
add text within the box. 


4-32 


Schematic Design Tools FIND 


4.6 FIND 


Find locates a string of text characters anywhere ina 
schematic worksheet and places the cursor at the object 
- containing the search string. A search string can be 
any number of characters that are grouped within the 
following items: 


Module ports 

Labels 

Reference designators 
Part values 

Sheet symbol names 
Power objects 


Find works only in the worksheet you are editing. 
When you select Find, DRAFT returns "Find?". 


Type the character string that you want to find, then 
press <ENTER>. DRAFT searches the worksheet for 
the desired character string and places the cursor near 
it. 


The next time you select Find, you will see the previous 
string on the prompt line. To search for a new string, 
use <RUBOUT> to erase the previous entry and type 
the new character string. 


If you are searching for a string identical to the last 
string (for example, you want to find all 200 ohm 
resistors on the worksheet), press <ENTER> with the 
current string name on the prompt line. DRAFT 
remembers the location of the previous string and 
searches for the next one. 


If you select Find after finding the last occurrence of 
the string, DRAFT "wraps" to the first occurrence of the 
string. If there is only one occurrence of the string, 
Find returns repeatedly to the string when the 
command is invoked. 
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4.7 GET 


Get retrieves objects from the part library database and 
places them in the worksheet as normal, rotated, or 
converted symbols. There are two ways objects can be 
retrieved from the library database. 


ile Select Get. DRAFT returns "Get ?” 


Type the desired object name exactly as it appears 
in the part library directory. If the name typed 
does not match the library directory, the prompt 
line shows an error message. To verify the 
spelling of an object name, use the LIBRARY 
Directory command. 


Press <ENTER> to show the symbol outline on 
the screen. Refer to Section 4.7.2 for information 
on rotating and placing parts on the worksheet. 


2: Select Get. DRAFT returns "Get ?" 


Press <ENTER>. DRAFT returns a 
subcommand menu displaying a list of part 
libraries. Select the library that you want to get a 
part from. 


When you select a library, a menu shows the 
selected library parts directory. Scroll the reverse 
video bar to the part name you select, then press 
<ENTER> to retrieve the part. The part outline 
symbol is placed on the screen. 


Refer to Section 4.7.2 for information on rotating 
and placing parts on the worksheet. 


You can select TTL and other library part numbers 


created with a prefix and shorthand string (refer to 
Section 7, The Prefix Definition) from the library by 
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entering the suffix. For example, suppose you want to 
retrieve a 74LS27 from the library. After invoking Get, 
you can use any of the following entries to retrieve the 
part: 


“A. Get? 74LS27 <ENTER> 
B. Get? LS27 <ENTER> 
C. Get?27 <ENTER> 


Example A uses the entire part name to retrieve the 
part. Example B uses the LS portion of the prefix to 
retrieve the part. Example C uses only the suffix of the 
part name. Since the prefix was not defined in example 
C, DRAFT displays a menu of all available TTL parts 
using "27" as a suffix. 


4.7.1. The Outline Symbol 


After you get the part from the library, the screen 
shows an outline of the part symbol. The outline symbol 
shows the size and shape of the part but contains little 
detail. Its function is to enable the part to move quickly 
around the worksheet. 


If the outline symbol remains stationary, the actual 
part symbol appears on the screen enclosed within the 
outline symbol. This enables you to view the layout of 
the part as it would appear when placed in the 
worksheet. 


4.7.2 Rotating and Placing Parts 


With the part selected and the outline symbol on the 
screen, DRAFT returns: 


Place Rotate Normal Up Over Down Mirror 
Find... 
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Jump Zoom escape Convert 


Move the symbol to where you want to place it. You 
may use these subcommands to rotate or place the part 
in the worksheet. 


Place 


Select this subcommand to place the part in the 
worksheet. 


Rotate 


Selecting this subcommand rotates the part 
counterclockwise 90 degrees. Parts rotate in the 
sequence up, over, down, and normal (Figure 4-5 shows 
a rotated part). 


Normal 


Use this subcommand to rotate a part to its original 
position, as retrieved from the part library. This 
subcommand also returns parts that have been 
mirrored or converted to other shapes with Convert to 
their original position (Figure 4-5 shows a part placed 
in its normal position). 


Up 
Select this subcommand to rotate a part 90 degrees 
counterclockwise (equivalent to rotating it once from its 


normal position). Figure 4-5 shows a part placed in the 
up position. 


Over 
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Select this subcommand to rotate a part 180 degrees 
counterclockwise (equivalent to rotating it twice from 
its normal position). Figure 4-5 shows a part placed in 
the over position. 


Down 


Select this subcommand to rotate the part 270 degrees 
counterclockwise (equivalent to rotating it three times 
from its normal position). Figure 4-5 shows a part 
placed in the down position. 


Mirror 


Select this subcommand to get a mirror image of a part. 
Figure 4-5 shows a part placed in the mirror position. 


Convert 


Many library parts have DeMorgan or other 
equivalent symbol forms. Ifa part has an equivalent 
symbol form, the Convert subcommand appears on the 
prompt line when it is retrieved from the library. 


Select Convert to convert the part to its alternate 
symbol form. You may see the converted part by 
leaving the outline symbol stationary. 


To return the converted part to its original symbol, 
select Normal. 


After you place a part on the worksheet, DRAFT keeps 
the same part selected. This enables you to repetitively 
place it without repeating the selection process. When 
you have placed all the parts, press <ESCAPE> to 
return to the main command level. 
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NOTE 


When an outline symbol is placed over the 
same part already placed on the worksheet, 
the part seems to disappear. Moving the 
outline symbol will display the originally 
placed part. 


MIRROR 


Figure 4-5. Parts Placed in the Normal, Rotated, Up, 
Over, Down, and Mirrored Positions 
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4.8 HARDCOPY 


The HARDCOPY command enables you to send a 
worksheet to the printer or to a file while in DRAFT. 
“HARDCOPY is not used to output to plotters. If you 
wish to plot a schematic, use the PLOTALL utility 
described in Section 6. 


DRAFT can make printouts of all worksheet sizes. 
Worksheets are printed in the normal printer 
orientation (horizontally). Ifa worksheet is too large to 
be oriented normally, it is printed sideways (vertically), 
and if still larger, it is printed normally in several 
sections. 


Output resolution depends on which printer driver you 
have configured. For example, there are four HP 
LaserJet printer drivers available with OrCAD/SDT III 
(75, 100, 150, and 300 dpi). If you have the 150 dpi 
driver configured, then the output resolution is 150 dots 
per inch. 


To make a printout, select HARDCOPY from the main 
command menu. DRAFT returns the following menu: 


Destination 

File Mode 

Make Hardcopy 
Width of Paper 


NOTE 
Be sure that your printer is connected to 


parallel port 1. Other parallel ports are not 
supported. 
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4.8.1 HARDCOPY Destination 


You can send a worksheet either to a printer or to a file. 
This command selects the hardcopy destination. When 
you select Destination, DRAFT returns the menu: 


LPT 
File 


Select LPT: to send your worksheet to a printer. 


Select File to send the worksheet to a binary file. When 
you select File, the prompt "Destination of Hardcopy?” 
appears followed by the default filename 
HARDCOPY.PRN. 


To change the filename, press <RUBOUT> enough 
times to erase the default name. Then, type the new 
filename followed by an <ENTER>. You can specify a 
complete pathname including a drive specification. 
Remember that because the output file is a graphics 
file, it requires more disk space than the corresponding 
schematic file. 


Files created this way may later be sent to the printer 

using the DOS COPY Command. For example, if you 
created a printer file called FRED.PRN, you can print 
it with the following DOS command: 


COPY FRED.PRN prn: /b 
Since the print file is a binary file, the DOS PRINT 
command will not work. For more information on 


COPY, refer to your DOS User's Manual. 


To return to the main command level, press 
<ESCAPE>. 
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4.8.2 HARDCOPY File Mode 


File Mode enables you to append or replace the contents 
of the hardcopy file. When you select File Mode, 
DRAFT returns the menu: 


Appended 
Replaced 


Select Appended to add new data to the contents of the 
destination file. With this command, you can save a 
series of hardcopies to the same file name. 


Select Replaced to replace the contents of the 
destination file with new data. This command 
overwrites the current contents of the destination file 
with the new hardcopy. 


To return to the main command level, press 
<ESCAPE>. 
4.8.3 HARDCOPY Make Hardcopy 


Make Hardcopy prints a hardcopy of the worksheet 
that you have displayed on the screen. It either sends it 
to your printer or to a file, depending on the setting of 
File Mode. 


To send a copy of your worksheet to your printer, first 
ensure that your printer has power and is online. Then, 
select Make Hardcopy. DRAFT displays the following 
message: 

::Creating Hardcopy of Sheet::: 


After a few seconds, the worksheet starts printing. 


For printing hierarchy or flat file structures, use the 
PRINTALL utility discussed in Section 6. 
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The Print Screen (PrtSc) key sends the worksheet 
contents that are displayed on the screen to a printer. 


4.8.4 HARDCOPY Width of Paper 

Width of Paper lets you choose between narrow and 
wide paper. To specify the width of the printer paper, 
select Width of Paper. DRAFT returns the menu: 


Narrow 

Wide 
Select Narrow if you have narrow paper (8 inches 
wide). Select Wide if you have wide paper (13 inches 
wide), 


To return to the main command level, press 
<ESCAPE>. 
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4.9 JUMP 


Jump enables you to quickly move the cursor to specific 
locations on the worksheet. The specific locations can 
be tags, grid references, or X - Y coordinates. For 
information on the tag command, refer to Section 4.16, 
the TAG Command. 


When you select Jump, DRAFT returns a screen menu 
where you can select from these subcommands: 


Tag 
Reference 
‘X- Location 
Y- Location 


4.9.1 JUMP Tag 


When you select Tag, the cursor jumps to the specified 
tag on the worksheet (the tag must have been 
previously set with the tag command). 


NOTE 


The error message "Tag does not exist” is 
displayed if the specified Tag has not been 
set. 


4.9.2 JUMP Reference 


The Reference subcommand moves the cursor to a 
specified grid reference on the worksheet border. Grid 
references are invisible until you set them with the SET 
Grid Parameters command. For information on grid 


4-43 


JUMP Schematic Design Tools 


parameters, refer to the SET Grid Parameters 
command in Section 4.15. 


To jump to a grid reference, follow these steps. 
i Select the Reference subcommand. 


2. DRAFT returns "Jump to Reference". Select the 
desired Y-axis alpha grid reference (A, B, C, or D) 
from the menu. 


3. Select the desired X-axis numeric grid reference 
(1 through 8) from the menu. 


4, The cursor jumps to the grid reference location 
that you specified and you return to the main 
command level. 


4.9.3 JUMP X Location 


This subcommand moves the cursor a specific distance 
in the X- direction. Each incremental step represents 
1/10th (0.1) inch on the worksheet if the SET Grid 
References Stay On Grid command is enabled; 
otherwise it is 1/100th (0.01) inch. The procedure for 
X-Location jumps is outlined below. 


5 Select the X-Location subcommand. 


2. DRAFT returns "Jump X". Enter the number of 
steps you want to jump A positive number moves 
the cursor to the right, and a negative number (- 
10, - 2.5, -30, etc.) to the left, the number of steps 
specified. If you enter 10 or +10, for example, the 
cursor jumps to the right 1 inch if you have 
enabled the SET Grid References Stay On Grid 
command. 
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3. When you press <ENTERs>, the cursor jumps to 
the grid reference location that you specified and 
you return to the main command level. 


4.9.4 JUMP Y Location 


This subcommand moves the cursor a specific distance 
in the Y- direction. Each incremental step represents 
1/10th (0.1) inch on the worksheet if the SET Grid 
References Stay On Grid command is enabled; 
otherwise it is 1/100th (0.01) inch. The procedure for 
Y-Location jumps is outlined below. 


Ls Select the Y-Location subcommand. 


2. DRAFT returns "Jump Y". A positive number 
moves the cursor down, a negative number (-10, - 
2.5, -30, etc.) up, the number of steps specified. If 
you enter 10 or +10, for example, the cursor 
jumps down 1 inch if you have selected the SET 
Grid References Stay On Grid command. 


3. When you press <ENTER>, the cursor jumps to 


the grid reference location that you specified and 
you return to the main command level. 
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4.10 LIBRARY 


The Library command enables you to display library 
part list directories and view the parts in libraries that 
are configured with DRAFT. When the library 
command is invoked, DRAFT returns a selection 
menu: . 


Directory 

Browse 
4.10.1 LIBRARY Directory 
The directory subcommand enables you to select a 
library and output its parts directory to screen, printer, 
or a file. When you select LIBRARY Directory, DRAFT 
returns a menu that displays a list of libraries that are 
currently configured in DRAFT. From the menu, 
select the library that you want a directory of. 


The next screen menu enables you to choose the output 
device (Screen, Printer, or File). 


Screen 

This subcommand sends the library directory to the 
screen. Press any key to continue. 

Printer 

Select this subcommand to send the library directory to 
a printer. 

File 

Select this subcommand to output and save the library 


directory to a file. DRAFT returns "File?" on the 
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prompt line. Enter the path and filename and press 
<ENTER>. 


4.10.2 LIBRARY Browse 


The browse subcommand enables you to view the 
contents of a library, or select a part and view it on the 
screen. To browse through the part libraries select the 
browse subcommand. Select All Parts or Specific Parts 
from the subcommand menu. 


NOTE 


Some devices may be too large to fit entirely 
on the screen. These devices may be viewed 
with the Get command. 


All Parts 


Select this option to view all parts in a library. DRAFT 
returns a menu showing a list of the libraries that are 
currently configured. Select the library that you want 
to view. A menu shows these subcommands: Forward, 
Backward, Quit. 


Select Forward or Backward to browse through the 
library. Quit returns you to the main command level. 
Specific Parts 


Select this option to view parts from the libraries. 
DRAFT returns "Part?". 


Type the name of the part that you want to view. Press 
<ENTER> to show the part on the screen. 
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4.11 MACRO 


The macro command enables you to capture, delete, 
initialize (erase), list, write to, and read macros from a 
file. 


Schematic capture often involves repetitive tasks such 
as creating memory arrays, connecting wires and 
buses, or labeling items in the worksheet. Keystroke 
commands that are used to perform these tasks can be 
stored as macros, assigned to a key or key combination, 
then replayed by pressing the assigned key. This 
makes the entry of often-used commands less tedious. 


DRAFT can record over 100 keyboard macros. These 
macros can be assigned to: function keys, selected 
keyboard keys, keys used with <CONTROL>, 
<SHIFT>, and <ALT>, or the middle button on a 
three-button mouse. 


When you create macros or load them from a macro 
file they are stored in memory allocated as a macro 
buffer. The macro buffer defaults to 16,384 bytes of 
memory. If the buffer fills, the prompt line shows a 
warning message. To get more buffer memory you can 
either increase the buffer size (refer to Section 2.4. ee 
or delete unused macros. 


To capture, delete, initialize, list, read, or write macros 
select the macro command from the main command 
level menu. DRAFT returns a selection menu of these 
subcommands: 


Capture 
Delete 
Initialize 
List 
Read 
Write 
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4.11.1 Valid Macro Key Names 


Figure 4-6 shows a list of the key names that may be 

- assigned as macros. The keys are illustrated as you 
would find them in a macro file. In the macro names, 
the following syntax has been used. The key names are 
as they appear on the keyboard with the exception of 
MMB which is the macro name of the Middle Mouse 
Button. 


is the name of the key that is pressed (such as 
HOME or A) 


{...} the curly braces indicate that the name... is a 
macro. 


A... indicates that the Ctrl key is pressed along 
with ... 


\... indicates that the ALT key is pressed along 
with ... 


SHIFT-... indicates that the SHIFT key is pressed 
along with ... 
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{*A} {ies {*C} {*D} {25} 
iE} 1G) Pang), {*J} POKSE 
{*L} {*N} {*O} (er {50} 
{*R} {7s er} {*U} (NT 
{*W} {*X} {eX} 122} 

{ oN} (ay Gr} (LN 

{\0} {\1} (V2) {Ns} {\4} 
{NSi} {\6} {\7} {\8} {\9} 
(NS) {\=} 

{\A} {\B} NG} {\D} {\E} 
{\F} {\G} {\H} CN {\J} 
{\K} {\L} {\M} {\N} {\O} 
{\P} {\Q} {\R} {\S} {\T} 
{\U} {\V} {\W} {\X} LNG) 
{\Z} 

{F1} {F2} {F3} {F4} {F5} 
{F6} {F7} {F8} {F9} {F10} 
{*F1} {*F2} {*F3} {*F4} (28S) 
(*F6} {Arz} {*F8} {*F9} {*F10} 
{SHIFT-Fl} {SHIFT-F2} {SHIFT-F3} {SHIFT-F4} {SHIFT-F5} 
{SHIFT-F6} {SHIFT-F7} {SHIFT-F8} {SHIFT-F9} {SHIFT-F10} 
(NE} GN Er2T {\F3} {\F4} {\FS} 
{\F6} {\E7} {\F8} (NEO {\F10} 
{BACK TAB} {DEL} {INS} {*RIGHT} {*LEFT} 
{END } { HOME } {PGDN} {PGUP } {*PGDN} 
{ *PGUP } {D} {L} {R} {U} 

{MMB } {MACROBREAK } 


Figure 4-6. Valid Macro Key Names 


4.11.2 MACRO Capture 


To create a macro, select the capture subcommand. 
DRAFT returns "Capture macro?" 


Press the key or keys you want to use for the macro 
label. The key(s) that you pressed appears on the 
prompt line. Refer to Figure 4-6 above, for a list of valid 
keys that can be assigned as macros. 


Press <ENTER>. DRAFT returns "<macro>", 
informing you that you are in the macro capture mode. 


4-50 


Schematic Design Tools , MACRO 


In the macro capture mode, DRAFT records any 
sequence of keystrokes or mouse commands. 
commands that you normally perform in DRAFT can 
be recorded and executed later as macros. 


- When you finish recording the macro keystrokes, press 


<M>. You can execute the macro anytime by pressing 
the key that you assigned. 


NOTE 


A macro can execute another macro or call 
itself from within a macro. 


4.11.3. Macro Examples 


1. This example macro displays the TTL parts 
directory to the screen. We'll assign the <F1> key 
to display the directory instead of sequencing 
through the commands. 


a. Select the macro command from the main 
command menu. 


b. Select the capture subcommand. 

c. Press <F1> at the "Capture macro?" prompt 
(assigns F1 to the macro), then press 
<ENTER>. You are now in the capture 


macro mode. 


d. Select the library command from the main 
command menu by pressing <L>. 


e. Select the directory subcommand. 


f. Select the TTL library. 
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Select the screen subcommand. 


h. The directory is now displayed on the screen. 
Press <ENTER> twice to continue. 


i. Press <M> to leave the macro capture mode. 
To execute the macro press <F1>. 

2. Using the PLACE command, this macro places 
junctions on the worksheet at the cursor location. 


We'll assign Ctrl A as the macro key. 


a. Select the macro command from the main 
command menu. 


b. Select the capture subcommand. 

c. Press the <Ctrl A> keys at the "Capture 
macro?" prompt, then press <ENTER>. You 
are now in the capture macro mode. 

d. Press <P> for the PLACE command. 


e. Press <J> for the junction subcommand. 


f. Press <P> to place the junction in the 
worksheet. 


g. Press <ESCAPE> to return to the main 
command menu. 


h. Press <M> to leave the macro capture mode. 


To execute the macro press <Ctrl A>. 
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4.11.4 Terminating a Macro between Commands 


You can capture and terminate a macro in the middle 
of a command sequence by simultaneously pressing 
<CTRL> and <END>. 


For example, we'll create a macro to simplify the 
procedure for drawing wires and assign it to F2. The 
macro will terminate after begin in the "PLACE Wire 
Begin" command. Enter the following from the 
keyboard: 


a. Press <M> for macro. 
b. Press <C> for capture macro. 
c. Press <F2>, then press <ENTER>. 


d. Press <P>, <W>, and <B>, for "place, wire, and 
begin". 


e. Press <CTRL> and <END> simultaneously. 


When F2 is pressed, you are automatically placed into 
the "PLACE Wire Begin" mode. To draw a wire, move 
the cursor around the worksheet with the cursor keys 
or mouse. 


4.11.5 Capturing a Macro and Pausing for a 
Keyboard Entry 


It is often handy to have a macro pause, enabling you to 
enter a keyboard command, before continuing. This is 
done as you create the macro by pressing <CTRL> 
<HOME> simultaneously where you want the macro 
to pause for keyboard input. 


Example: 


4-53 


MACRO Schematic Design Tools 


Let's assign the macro we create to F3. We want to 
scroll through the Intel library directory, retrieve a 
part, move it to a worksheet location, place it, and 
return to the main command menu. 


Enter the following: 

a. Press <M> for macro. 

b. Press <C> for capture macro. 

c Press <F3>, then press <ENTER>. 

d. Press <G> GET, then press <ENTER>. 

e. |A window appears listing the libraries. Place the 
highlighted bar over the Intel library, then press 
<ENTER>. 


f. Press <CTRL> <HOME> simultaneously, then 
press <ENTER>. 


g. Press <CTRL> <HOME> again simultaneously, 
then press <ENTER>. 


h. Press <ENTER> again. 


i. Press <ESCAPE> (this returns you to the main 
command level). 


i Press <M> to close the macro. 


When you press F3, the macro runs and stops with the 
Intel library window showing on the screen. You select 
the desired part, then press <ENTER>. The macro 
continues, then stops, displaying the "Place, Rotate..." 
menu. You may move the part around the worksheet 
and place it by pressing <ENTER>. The part must be 
placed using the <ENTER> key, not by typing <P>. 
This is because, a macro that has paused is waiting for 
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the <ENTER> key to be pressed, enabling the macro to 
continue running. 


DRAFT then returns you to the main command menu. 


NOTE 


When capturing macros and pausing for a 
keyboard entry, a macro that has paused is 
waiting for <ENTER> to be pressed. If you 
can't execute another macro, this indicates 
that the previous macro was not terminated 
properly using the <ENTER> key. If this 
occurs, simply press the <ENTER> key to 
clear the previous macro. 


4.11.6 Executing a Macro 


To execute a macro, press the key or key sequence 
assigned to it. For example, if the Alt F5 keys are 
assigned to a macro, press the two simultaneously. 


4.11.7 MACRO Delete 


To delete a macro select the delete subcommand. 
DRAFT returns "Delete macro?” Enter the execution 
key (macro name) for the macro that you wish to 
delete, then press <ENTER>. 


4.11.8 MACRO Initialize 
This subcommand erases all macros. To erase all of the 


macros, select the Initialize subcommand. DRAFT 
returns "Erase All Macros?" 
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Select "No" to return to the main command menu, or 
"Yes" to erase all macros. 


4.11.9 MACRO List 


This subcommand shows a list of all the key names 
assigned to macros. To display the macro list select the 
list subcommand. 


4.11.10 MACRO Write 


This subcommand enables you to save all macros 
currently in DRAFT to a file. To save the macros to a 
file select write. DRAFT returns "Write all macros to?" 


Type the path and filename and press <ENTER> to 
write the macros to the file. 


Macro files may be automatically loaded each time 
DRAFT is invoked by placing the macro file name in 
the "Configuration of OrCAD/SDT III" menu (refer to 
Section 2.4.9). 


4.11.11 MACRO Read 

The Read subcommand enables you to load a macro file 
into DRAFT. To load a macro file select the Read 
subcommand. DRAFT returns "Read all macros 
from?" 

Enter the path and file name that the macros are 
stored in, then press <ENTER> to load the macro file. 
4.11.12 Macro File Format 


A macro format is a simple ASCII file, and may be 
edited or created using a text editor. If you want to 
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examine or modify a macro, the syntax of a macro 
definition is shown in Figure 4-7 below: 


MACRO DEFINITION 
All of the 
Bay NANG} [= |---| Macro Text 


Where: "Key Name" is a valid Macro Key. 
“All of the Macro Text” are 
the components of the Macro. 


Figure 4-7. Macro Definition Syntax Diagram 


From the left side, the macro has its key name enclosed 
in curly brackets ({keyname}). An equal sign (=) is 
next, showing that the macro text follows. Next is the 
macro text. Finally, the macro is terminated with a left 
curly bracket followed by a right curly bracket ({}). 


Example: 
Here is an example of a macro defined in a text file: 
{F1}=g2115{ENTER}p{ESC}{} 


This macro uses the function key Fl as a key name (F1 
is enclosed in curly brackets). The macro text follows. 
The "g" executes GET, and 2115 says that library part 
2115 is to be retrieved from the library. {ENTER} 
executes the <ENTER> command, p executes PLACE, 
and {ESC} executes the <ESCAPE> command. Finally, 
the curly brackets terminate the macro. 


4.11.13 Nesting Macros 
You may also nest macros, in which one macro calls 
another. To nest a macro, press the key name of a 


previously saved macro when you are capturing a new 
one. For example: If you are assigning F3 as a new 
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macro, and you want to nest the macro assigned to F2 
within the new macro, press F2 at the appropriate time 
while you are creating the new macro. 


To nest a macro in a file, insert the macro key, enclosed 
by curly brackets, inside the text of another macro. For 
example: 


{F3}=g2115{F2}{} 


4.11.14 OrCAD Supplied Macros 


Included on the MASTER SOFTWARE DISK 1, isa 
sample macro file called MACRO.MAC. If you want to 
use these macros, be sure to install the MACRO.MAC 
file in the ORCAD root directory. Then, configure 
DRAFT to load this file as outlined in Section 2.4.9. For 
a complete description of each macro, refer to Appendix 
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4.12 PLACE 


The place command enables you to place wires, buses, 
junctions, bus entries, labels, module ports, power, 
dashed lines, and hierarchical sheets on your 
worksheet. 


Select place from the main command menu. DRAFT 
returns a selection menu with these subcommands: 


Wire 

Bus 
Junction 
Entry (Bus) 
Label 
Module Port 
Power 

Sheet 


4.12.1 PLACE Wire 


To place wires in the worksheet, select the wire 
subcommand. DRAFT returns: 


Begin Find Jump Zoom escape 
To draw a wire, place the cursor on the worksheet 
where you want the wire to start. Follow the procedure 
outlined in the next paragraph. 
Select Begin. DRAFT returns: 

Begin End New Find Jump Zoom escape 


Draw the wire by moving the cursor. Select one of the 
following subcommands to finish drawing the wire: 
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Repetitively entering begin while the wire is being 
drawn enables you to redefine the wire's origin where it 
makes a 90 degree turn. 


To continue drawing the wire from the 90 degrees 
turn, select begin where the turn starts (point A in 
Figure 4-8). You may also move to the end of the wire 
(point B in Figure 4-8) and select either Begin, End, or 
New, to fill itin. Dashes show a wire that has not been 
filled in by using the Begin, End, or New subcommands. 


Begin End Find Jump Zoom escape 


Figure 4-8. Drawing a Wire 


Continue drawing the wire until you come to where 
you want it to end. To connect the wire to an end point, 
select either the End or New subcommands. 


End 
With the cursor at the end point select end. When you 


invoke this command, the program returns you to the 
main command menu. 
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New 
With the cursor at the end point select new. This 
subcommand enables you to remain in the wire placing 


mode, and returns you to the Begin, Find, Jump, Zoom, 
and escape prompts. 


NOTE 


Refer to Section 4.11.4 for example macros 
that simplify wire placement. 


CAUTION 
Wire and bus ends must not overlap library 
part pins or each other. NETLIST and ERC 


interpret these as "opens". Always place 
wire and bus ends end-to-end. 


4.12.2 PLACE Bus 


To place buses on the worksheet select the bus 
subcommand. DRAFT returns: 


Begin Find Jump Zoom escape 
To draw a bus, place the cursor at the worksheet 
location where you want the bus to start. Select Begin. 
DRAFT returns: 

Begin End New Find Jump Zoom _ escape 


Draw the bus by moving the cursor, then select end to 
complete it. 
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Drawing a bus is identical to drawing a wire (refer to 
Section 4.12.1, PLACE Wire command). 


NOTE 


If you are using the NETLIST utility 
program, you must label each bus witha 
label in the following format: 


BUSNAME[0..n] 


Where n is the decimal number of the last 
bus member, and BUSNAME is the name of 
the bus. Refer to Section 6, NETLIST, for 
more information. 


4.12.3 PLACE Junction 


On a worksheet, many wires and buses connect or cross 
each other. Junctions are placed on the worksheet to 
distinguish a connection from a cross-over. If you 
intend to have more than two wires or buses connect to 
a common node, always place a junction at that point. 
This tells the ERC and NETLIST utility programs that 
the node is a physical connection. 


If you don't place a junction at an intersection of wires 
or buses, ERC and NETLIST interpret the intersection 
as a cross-over. 


In many designs, you may want to connect a wire at 90 
degrees to a bus. If you do, you must place a junction at 
the connect point. Junctions are not required if you use 
a bus entry (refer to Section 4.12.4). 


To place a junction in the worksheet, select the junction 
subcommand. DRAFT returns: 
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Place Find Jump Zoom _ escape 


Position the cursor where you want the junction and 
follow the procedure for the place subcommand 
(described below). 


Place 


Use this subcommand to place the junction where you 
want it on the worksheet. The program remains in the 
"PLACE Junction" mode until <ESCAPE> is pressed. 


4.12.4 PLACE Entry (Bus) 


The entry (Bus) subcommand enables you to place bus 
entries on the worksheet. Bus entries are used for 
aesthetic purposes to connect wires or other buses to a 
bus. Figure 4-9A shows a series of wire bus entries; 
Figure 4-9B shows a bus bus entry used for a bus turn. 


A B 


Figure 4-9. Illustrations of Bus Entries 


When you select PLACE entry, DRAFT shows the last 
bus entry selected, with this subcommand menu: 


Place / \ Wire Bus Find Jump Zoom 
escape 
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To place a bus entry, select the place subcommand. 
Select the / or \ subcommands to change the bus entry 
angle. DRAFT shows the last bus entry angle when you 
invoke the Place Entry (Bus) command. 


Select the Wire subcommand to place wire thickness 
entries. Use this subcommand when a wire is to exit or 
enter a bus from another object. 


Select the Bus subcommand to place bus thickness 
entries. Use this subcommand when a bus makes a 
turn or is joined to another bus. 


NOTE 


Junctions are not required to be placed in the 
worksheet to connect an angled bus entry to 
a bus. 


4.12.5 PLACE Label 


A label is an identifier placed on a worksheet that can 
connect signals (wires and buses) together without 
actually physically connecting them. You can place 
labels horizontally or vertically on a worksheet. 


To place a label, select the Label command. DRAFT 
returns the prompt: "Label?" Type the name of the label 
followed by an <ENTER>. DRAFT then returns the 
menu: 


Place Orientation Value Larger Smaller Find 
Jump Zoom escape 


Select Place to place the label on the worksheet. Before 
placing the label, you can make it horizontal or vertical 
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with Orientation, change its text with Value, or change 
its size with Larger or Smaller. 


Note that labels are not comments. Labels have 
meaning for other utilities such as NETLIST. To place 
- a comment on the worksheet, use the Place Text 
command. 


When the label is placed, the "Label?" prompt returns. 
You can now place another label or press <ESCAPE> to 
return to the main command menu. 


NOTE 


If you use the NETLIST utility program, 
you must follow the procedure for placing 
labels. Refer to the description of the 
NETLIST utility in Section 6 for detailed 
information. 


4.12.6 Correct Label Positioning 


For the ERC and NETLIST utility programs to 
associate internal and bus member labels to wires and 
buses, labels must be placed with the leftmost point of 
the label name next to the bus or wire. The bottom of 
the leftmost character is the "hotpoint"; it must have 
contact with the bus or wire. 


Figure 4-10 shows correct label positions for both 
vertical and horizontal wires. Notice LABEL4, the 
hotpoint (lower portion of the character "L") is closest to 
the wire. 
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Figure 4-10. Correct Label Positions 


Figure 4-11 shows incorrect label positions. None of the 
label hotpoints are next to the wire. LABEL21 for 
example, has its hotpoint (lower portion of the 
character "L") away from the wire. 
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Figure 4-11. Incorrect Label Positions 


4.12.7 PLACE Module Port 


A module port connects hierarchical and flat file signals 
that leave a worksheet to signals in other worksheets 
having the same name. Unspecified module ports are 
also used to transfer power from one sheet to another. 
Module ports may be connected to either wires or buses. 


Signals that remain internal to the worksheet should be 
labeled as labels, not as module ports. 


To place a module port, select the Module Port 
command. The prompt "Module Port Name?" then 
appears. Type the module port name followed by an 
<ENTER>. DRAFT then returns the menu: 


Input Output Bidirectional Unspecified 
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Select Input if the module port is used as a signal input, 
Output if the module port is used as a signal output, 
Bidirectional if the module port is used as a bidirectional 
signal, or Unspecified if the module port is used to 
transfer power or "don't care” signals. 


NOTE 


An unspecified module port must be used if 
power is transferred between worksheets. 
For additional information, refer to 
NETLIST in Section 6. 


When you select one of the above commands, DRAFT 
returns the module port name to the screen. You may 
move it where you want it before placement. The 
following menu appears: 


Place Value Type Style Find Jump Zoom 
escape 


Select Place to place the module port on the worksheet. 
Before placing the label, you can change its Value, Type, 
or Style. 


A module port's value is whatever you typed after 
"Module Port Name?". Its type is input, output, 
bidirectional, or unspecified. Its style is how it looks on 
the screen. If you select Style, you can choose from the 
following: 


Right pointing 
Left pointing 
Both pointing 
Neither pointing 
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A module port's style is independent from its type. For 
example, a Both pointing style does not imply that the 
module port is Bidirectional. 


Select Place to place the module port. The prompt 
"Module Port name ?" returns, enabling you to place 
another module port. Press <ESCAPE> to return to 
the main command menu. 


Figure 4-12 illustrates the four types of module ports 
with their default styles. 


BIDIRECTIONAL 


Figure 4-12. Input, Output, Bidirectional, and 
Unspecified Module Ports 


NOTE 


Module ports are not intended to be used as 
physical connecters, such as DB-9 etc. 
Physical connectors are objects that should 
be created as library parts. For information 
on working with connectors, refer to Section 
6, the NETLIST utility. 
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4.12.8 PLACE Power 


Select the PLACE Power command to place power 
supply objects on the worksheet. 


To place a power object on a worksheet, select Power. 
DRAFT returns the menu: 


Place Orientation Value Type Find Jump 
Zoom escape 


The power object appears on the screen ready to be 
positioned and placed on the worksheet. Before placing 
the power object on the worksheet, you can change its 
orientation, value or type. 


If you select Orientation, you can choose Top, Bottom, 
Left, or Right. 


A power object's value is the text (for example, VCC) 
associated with it. If you select Value, DRAFT returns 
the prompt "Power Value? xxx" where xxx represents 
the current value. You can backspace over the current 
value or append to it. After typing the new value (for 
example, +5 , GND, + 5 VDC, -12 VDC, VSS, VEE, or 
any other text string), press <ENTER> to return to the 
menu. 


A power object's type is its appearance on the screen. If 
you select Type, you can choose Circle, Arrow, Bar, or 
Wave. 


Select Place to place the power pin where you want it 


on the worksheet. Then, press <ESCAPE> to return to 
the main command menu. 
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NOTE 


The power pin default is a circle with a 

_ value of VCC. When you execute PLACE 
Power, the orientation is forced to the top. 
Type and value will be those used previously. 


If you use the NETLIST utility program, refer to 
Section 6 for information on handling power in battery 
backup and other applications. 


Figure 4-13 shows the four kinds of power objects and 
their orientations. 


Figure 4-13. Circle, Arrow, Bar, and Wave Power 
Objects and their Orientations 


4.12.9 PLACE Sheet 


DRAFT helps you create hierarchical designs with 
sheet symbols. The sheet symbol, representing a 
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worksheet in a hierarchy, contains net names used to 
interconnect the present worksheet and the sheet 
represented by the symbol. 


To place a sheet symbol select Sheet. Draft returns the 
menu: 


Begin Find Jump Zoom escape 


Select Begin, outline the area, then select End to finish 
it. DRAFT then returns the menu: 


Add Delete Edit Name filename Size Zoom 
escape 


Cursor movement is restricted to within the box walls 
of the hierarchical sheet. This enables you to place the 
cursor where you want the sheet names and nets. 


Add 


Add is used to add net connections between worksheets. 


To add a net sheet connection, place the cursor at the 
edge of the box where you want the name and select 
Add. DRAFT returns the prompt "Net Name?" Type 
the net name followed by an <ENTER>. DRAFT then 
returns the menu: 

Input Output Bidirectional Unspecified 


Select the appropriate type for your sheet connection. 


Delete 


To delete sheet connections, place the cursor at the 
connection's location and select Delete. 
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Edit 


To edit a sheet connection, place the cursor at the 
connection's location and select Edit. DRAFT then 
presents a menu that allows you to choose between 
Name and Type. 


To edit the net name, select Name. When the net name 
appears on the prompt line, press <RUBOUT> to erase 
it. Then, type the new net name and press <ENTER>. 


To edit the net type, select Type. You can then chose 
Input, Output, Bidirectional, or Unspecified. 


Name 


The Name command allows you to edit the sheet name. 
The default sheet name is a question mark (?) located at 
the top of the sheet. Typical sheet names may be 
"Memory Array" or “Dynamic RAM Refresh 
circuitry’. 


To specify a sheet name, select Name. DRAFT returns 
"Sheet Name?" followed by the current sheet name. 
Press <RUBOUT> enough times to erase the current 
name. Then, type the desired sheet name. Press 
<ENTER> to place it at the top of the sheet. 


Filename 


Filename enables you to name the file representing the 
hierarchical worksheet. DRAFT automatically 
generates a filename based on the date and time of day 
that the sheet was created. This ensures that no two 
filenames will be the same. 


The DRAFT-generated name appears on the prompt 
line when Filename is selected. 
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If you want to rename the file, select Filename and 
press <RUBOUT> enough times to erase the current 
name. Then, type the new name followed by an 
<ENTER>. 


Size 


Size increases or decreases the sheet size. When you 
select Size, DRAFT returns the menu: 


End Jump Zoom _ escape 


The cursor is automatically positioned on the lower 
right corner of the sheet. To change sheet size, move 
the cursor until you reach the desired size. Then, select 
End. 


For more information, refer to Section 4.5.4, Editing 
Sheets, and Section 5.0, Hierarchy. 


4.12.10 PLACE Text 


Text allows you to place comments on your worksheet. 
Comments are useful for placing revision history, 
tolerance, and other information in the worksheet. 


When you select Text, DRAFT returns the prompt 
"Text?". Type the text that you want as a comment and 
follow it with an <ENTER>. The following menu then 
appears: 


Place Orientation Value Larger Smaller Find 
Jump Zoom escape 


Before placing the comment on the worksheet, you can 
change its orientation, value, and size. If you choose 
Orientation, you can choose between horizontal and 
vertical. If you choose Value, you have the opportunity 
to edit the text before you place it. If you choose Larger, 
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you make the text larger; and if you choose Smaller, 
you make it smaller. 


To place the text comment on the worksheet, select 
Place. 


4.12.11 PLACE Dashed Line 


Dashed Line allows you to place a dashed line on the 
worksheet. This is often useful to set off logical sections 
of your design. You can then label those sections with 
comments constructed with PLACE Text. 


Placing a dashed line is similar to placing a wire. When 
you select Dashed Line, DRAFT returns the menu: 


Begin Fine Jump Zoom escape 


To draw a dashed line, select Begin. Then move the 
cursor to draw the line. End the line with End and 
change direction with Begin. New ends the current 
line, but allows you to begin a new line at a different 
location with Begin. 
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4.13 QUIT 


With the Quit command, you can enter and leave 
hierarchical worksheets, load, update, and write to files, 
clear the worksheet, suspend to DOS, abandon edits, 
and invoke PSpice and its options. When Quit is 
invoked, DRAFT returns the following menu: 


Enter Sheet 
Leave Sheet 
Update File 
Write to File 
Initialize 
Suspend to DOS 
Abandon Edits 
PSpice 

Probe 

Parts 


4.13.1 QUIT Enter Sheet 


The Enter Sheet command enables you to enter a 
hierarchical worksheet. If you are working on a 
worksheet, and want to enter another worksheet, select 
Enter Sheet. 


If you have made any changes to the current 
worksheet, DRAFT returns "Abandon changes made?" 


This message tells you that you will lose any changes 
made to the worksheet during the current work 
session. Select No to abandon the Enter Sheet 
command. If you select Yes, all changes made to the 
worksheet are lost, and DRAFT returns the menu: 
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Enter Leave Find Jump Zoom _ escape 


Place the cursor inside the sheet symbol for the sheet 
that you wish to enter and select Enter sheet. For 
information about saving your latest design session to a 
file, refer to Section 4.13.3, QUIT Update File. 


DRAFT returns the Enter Sheet menu, enabling you to 
enter other worksheets. Press <ESCAPE> to return to 
the main command level. 


4.13.2 QUIT Leave Sheet 


To leave a hierarchical worksheet select Leave Sheet 
subcommand. When you invoke this command, you 
move one level up in the command hierarchy. If you 
are at the top of the command hierarchy, DRAFT 
displays an error message briefly on the prompt line 
telling you that you are already at the root level. 


4.13.3 QUIT Update File 


Update is used to write your latest worksheet design 
session to a file. Toupdate a file, select Update. If the 
current worksheet had been previously loaded from a 
file, that file is updated. If the current worksheet is 
unnamed, DRAFT responds with "Write to File?" 


Type the desired filename and press <ENTER>. 


To update a file other than the current file, use the 
QUIT Write File command. 


Press <ESCAPE> to return to the main command 
menu. 
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4.13.4 QUIT Write File 


The Write File enables you to save the current 
worksheet to any file youspecify. When invoked, 
DRAFT returns "Write to File?" 


Type the desired path and file name followed by an 
<ENTER>. The worksheet is saved to the file specified, 
and DRAFT returns the QUIT menu. 


Press <ESCAPE> to return to the main command 
level. 


4.13.5 QUIT Initialize 


Initialize enables you to either load a worksheet file or 
erase everything from it, thus clearing it. To perform 
these tasks select QUIT Initialize and follow one of the 
two procedures outlined below. 


If there are objects on the worksheet, DRAFT returns 
"Are you sure? Yes or No". Select No to abandon the 
Initialize command and return to the main command 
level. Select Yes to clear the worksheet. 


With a clear worksheet, DRAFT returns "Load File?" 
Type the filename that you wish to load followed by an 
<ENTER>. Ifthe filename exists, the worksheet is 
loaded and displayed. If the filename does not exist, 
DRAFT returns <<<new worksheet>>>. 


Press <ESCAPE> to return to the main command 
level. 
4.13.6 QUIT Suspend to DOS 


Suspend to DOS enables you to temporarily leave 
DRAFT and the worksheet, save the worksheet in 
memory, and return to DOS. Once you have suspended 
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DRAFT, you may perform DOS functions, including 
using other software programs as long as there is 
enough computer memory. 


To suspend to DOS, select Suspend to DOS. DRAFT 
suspends operation, loads the DOS command 
interpreter, and adds an additional ">" to the DOS 
command prompt. This is a reminder that DRAFT is 
suspended and in the "background". For example: 


A> This is the DOS prompt that tells you drive A is 
thede fault drive. 


A>> This is the DOS prompt that tells you drive A is the 
default drive and that you have also suspended 
DRAFT in the background. 


To return to DRAFT, type exit at the DOS prompt. 
DRAFT then comes to the"foreground,” and the 
worksheet that you were working on when you 
suspended DRAFT returns to the screen. 


4.13.7 QUIT Abandon Edits 


Select Abandon Edits to exit DRAFT and return to DOS. 
If objects have been placed on the worksheet since the 
last update, DRAFT returns "Are you sure? Yes or No" 
on the subcommand menu. Select NO to abandon the 
command. Select Yes to quit and return to DOS. 


4.13.8 QUIT PSpice 


Select PSpice to invoke the PSpice analog simulator. 
When you select PSpice, you execute the OrCAD- 
supplied batch file called PSPICE.BAT. To implement 
this command, you must have purchased the PSpice 
analog simulator and have it installed in the ORCAD 
root directory. 
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This batch file expects the existence of two other files. 
One is "filename.CIR" and the other is "filename.NET", 
where filename is the name of your schematic file 
minus any file extension. You must create the .CIR file; 
the .NET file is created by DRAFT when you select 
PSpice. 


filename.CIR 


This file contains the specifications of the parts 
used in your schematic as well as PSpice control 
statements. 


filename.NET 


This file contains the connectivity information 
specific to your schematic that’s needed by PSpice. 


When you exit PSpice, you return to DRAFT. For 
information on the requirements of the .CIR file, refer (Co 
to the PSpice manual. < 


4.13.9 QUIT Probe 


Probe is a PSpice utility that aids the display of PSpice 
data. When you select Probe, DRAFT returns the 
prompt "Probe? PROBE.DAT." To implement this 
command, you must have purchased the PSpice analog 
simulator and have it installed in the ORCAD root 
directory. 


PROBE.DAT is the name of the file made by PSpice. It 
contains the data describing the result of the PSpice 
simulation. If you have renamed this file and want to 
invoke Probe on the renamed file, backspace over 
PROBE.DAT and type the new filename followed by an 
<ENTER>. If you accept the name PROBE.DAT, just 
press <ENTER>. 
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When you exit Probe, you return to DRAFT. For 
additional information, refer to the PSpice manual. 


4.13.10 QUIT Parts 


Parts is a PSpice utility that allows you to define the 
mathematical model used by the parts in your 
schematic. When you select Parts, this utility is 
invoked. To implement this command, you must have 
purchased the PSpice analog simulator and have it 
installed in the ORCAD root directory. 


When you exit Parts, you return to DRAFT. For 
additional information, refer to the PSpice manual. 
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4.14 REPEAT 


When the Repeat command is invoked, DRAFT 
repeats the last entered object or label placed on the 
worksheet. Repeats are defined in Section 4.15.13, SET 
Repeat Parameters. 

Example: 


You want to repeat and auto-increment a bus 
member label, a unit of one in the Y direction, at 
1/10 inch steps. You want to place the labels in the 
range of AO through A7. You set the following 
parameters in the SET repeat parameters 
command of Section 4.15.13 below. 

X Repeat Parameters = +0 

Y Repeat Parameters = +1 

Label Repeat Delta = +1 

Auto Increment Place = Not used in this example 


Procedure: 


ie Use the PLACE Label command and enter "AO" 
at the "Label?" prompt. 


2. Select bus member as the label type. 


3. Place the cursor where the label goes on the 
worksheet. 


Za Place the label. 


5. Press <ESCAPE> to return to the main 
command menu. 


6. Press <R> to repeat. 
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7. Repeat step 6 until you have placed all the labels 
from AO to A7. 
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4.15 SET 


With the SET command, you can enable or disable the 
following DRAFT options: 


Auto panning 

Backup files 

Dragging buses when rubberbanding 
The error bell 


Having the left mouse button release execute 
<ENTER> 


Macro prompts 


Drawing non-orthogonal wires 


4nd 


Showing pin numbers 
Disabling the standard title block 


Displaying cursor coordinates, grid dots, and grid 
references 


Enabling the cursor to move off-grid 
Setting repeat parameters 


The worksheet size, A through E 


To change the status of an option, select SET. DRAFT 
returns the following menu: 
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Auto Pan 
Backup File 
Drag Buses 
Error Bell 

Left Button 
Macro Prompts 
Orthogonal 
Show Pins 

Title Block 
Worksheet Size 
X,Y Display 

Grid Parameters 
Repeat Parameters 
Visible Lettering 


4.15.1 SET Auto PAN 


Auto pan enables movement past the screen boundary. 
When the cursor crosses a screen boundary, the screen 
pans in the direction the cursor is moving. 


When you select Auto Pan, DRAFT lets you choose 
between Yes and NO. Yes enables auto panning; No 
disables it. 


4.15.2 SET Backup File 


Backup File enables the creation of a backup file of your 
worksheet when you write or update files using the 
QUIT command. The backup file contains the previous 
version of your edited worksheet. 


When you select Backup File, DRAFT lets you choose 
between Yes and NO. Yes enables the creation of 
backup files; No disables it. 
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NOTE 


Disabling Backup File can be dangerous. If 
your file should accidentally become 
damaged or erased, you will be unable to 
recover it. 


4.15.3 SET Drag Buses 


Drag Buses allows buses to be rubberbanded when you 
select a BLOCK Drag command. Because there are 
more points to locate when rubberbanding, system 
performance decreases when the BLOCK Drag 
command is executed. 


When you select Drag Buses, DRAFT lets you choose 
between Yes and NO. Yes enables the rubberbanding of 
buses; No disables it. 


4.15.4 SET Error Bell 


Error Bell gives you the ability to enable or disable the 
error bell (your computer's speaker). When you enable 
this option, error messages and errors sound the 
speaker. 


When you select Error Bell, DRAFT lets you choose 
between Yes and NO. Yes enables the error bell; No 
disables it. 


4.15.5 SET Left Button 


When Left Button is enabled, releasing the left mouse 
button executes the <ENTER> command for 
command line menus only. Pressing the left mouse 
button continues to execute the command that the 
video bar highlights. 
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When you select Left Button, DRAFT lets you choose 
between Yes and NO. If you select Yes, then releasing 
the left button on your mouse executes an <ENTER>. 
If you select No, then releasing the left button on your 
mouse does not execute an <ENTER>. 


4.15.6 SET Macro Prompts 


When Macro Prompts is enabled, the commands 
making up your macros are displayed on the screen 
when the macro is invoked. This option is useful for 
debugging macros or to observe the commands being 
performed when you invoke the macro. For 
information about macros, refer to Section 4.11. 


When you select Macro Prompts, DRAFT lets you 
choose between Yes and NO. Yes enables macro 
prompts; No disables them. 


4.15.7 SET Orthogonal 


When Orthogonal is enabled, wires and buses are 
drawn orthogonally (perpendicular to each other). 
When disabled, wires and buses may be drawn at any 
angle. 


When you select Orthogonal, DRAFT lets you choose 
between Yes and NO. Yes restricts wires and buses to 
be orthogonal; No allows them to be drawn at any 
angle. 


4.15.8 SET Show Pin Numbers 


When Show Pin Numbers is enabled, library part pin 
numbers for library parts are shown on the screen. 
When disabled, pin numbers are not shown on the 
screen. Worksheet hardcopies, in either case, print 
with pin numbers shown. 


4-87 


SET Schematic Design Tools 


When you select Auto Pan, DRAFT lets you choose 
between Yes and NO. Yes enables the display of pin 
numbers; No disables it. 


4.15.9 SET Title Block 


When Title Block is enabled, the standard title block is 
placed on the worksheet. With the option disabled, you 
may create a custom title block using the PLACE 
Wire/Bus and PLACE Text commands. 


When you select Title Block, DRAFT lets you choose 
between Yes and NO. Yes enables the display of the 
standard title block; No disables it. 


4.15.10 SET Worksheet Size 


Worksheet Size enables you to select the worksheet size, 
A through E. 


When you select Title Block, DRAFT lets you choose a 
letter from A throughE. The size corresponding to the 
letter is set in the Template Table during configuration. 


4.15.11 SET X,Y Display 


When X,Y Display is enabled, the upper right part of 
the prompt line shows the cursor coordinates. The 
worksheet origin (0,0) is the upper left corner. 
Coordinates do not appear on the screen until the 
cursor is moved. 


When you select X,Y Display, DRAFT lets you choose 
between Yes and NO. Yes enables the display of the 
cursor coordinates; No disables it. 
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4.15.12 SET Grid Parameters 


Grid Parameters enables you to select grid references, 
stay on grid, and display visible grid dots. When you 
select Grid Parameters, DRAFT returns the following 
menu: 


Grid References 
Stay on Grid 
Visible Grid Dots 


Grid References 


When Grid References is enabled, an alphanumeric 
border on two of the four worksheet sides shown on the 
screen. The top border shows grid reference numbers, 
and the left border shows reference letters. The borders 
are scaled to the size of the worksheet. 


When you select Grid References, DRAFT lets you 
choose between Yes and NO. Yes enables the display of 
the alphanumeric border; No disables it. 


Stay on Grid 


When Stay on Grid is enabled, this command confines 
the cursor to the predefined grid. When disabled, the 
cursor may be moved off grid to any position on the 
worksheet at a resolution ten times that of the grid. 


When you select Stay on Grid, DRAFT lets you choose 
between Yes and NO. Yes restricts the cursor to the 
grid; No does not. 
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CAUTION 


Placing objects, wires, and buses with Stay 
on Grid disabledmay cause errors when 
using ERC and NETLIST. This is because 
wires and buses may look as if they are 
connected,when in fact, they are not. ERC 
and NETLIST may interpretthese 
connections as opens. OrCAD recommends 
that you do not place objects, wires, or buses 
in the worksheet with this parameter 
disabled. 


Visible Grid Dots 


When Visible Grid Dots is enabled, visible grid dots are 
displayed on the worksheet spaced 1/10 XY unit on 
Zoom scale 1, 2/10 XY unit on Zoom scale 2, 1/2 XY unit 
on Zoom scale 5,1 XY unit on Zoom scale 10, and 2 XY 
units on Zoom scale 20. 


When you select Visible Grid Dots, DRAFT lets you 
choose between Yes and NO. Yes enables the display of 
grid dots; No disables it. 


4.15.13 SET Repeat Parameters 


Repeat Parameters has four subcommands that are 
used to set the REPEAT command parameters. When 
you select Repeat Parameters, DRAFT returns the 
following menu: 


X Repeat Step 

Y Repeat Step 

Label Repeat Delta 
Auto Increment Place 


X Repeat Step 
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X Repeat Step determines the number of unit steps in 
the X- direction the object being repeated is offset from 
the original object. The X-direction goes horizontally 
across the worksheet, with positive to the right and 
negative to the left of the current cursor position. A unit 
step is defined as 1/10 XY unit when on-grid, and 1/100 
XY unit when off-grid. When you select X Repeat 
Step, the prompt "X Repeat Step?" appears. Enter any 
whole-number integer followed by an <ENTER>. 


Y Repeat Step 


Y Repeat Step determines the number of unit steps in 
the Y- direction the object being repeated is offset from 
the original object. The Y-direction goes vertically on 
the worksheet, with positive down and negative up 
from the current cursor position. A unit step is defined 
as 1/10 XY unit when on-grid, and 1/100 XY unit when 
off-grid. 


When you select Y Repeat Step, the prompt "Y Repeat 
Step?" appears. Enter any whole-number integer 
followed by an <ENTER>. 


Label Repeat Delta 


Label Repeat Delta determines how much the numeric 
suffix information on a label changes, and in what 
direction, when the label is repeated. When you select 
Label Repeat Delta, the prompt "Label Repeat Delta?" 
appears. If you enter a positive number followed by an 
<ENTER3>, label suffixes are incremented by that 
number when the REPEAT command is invoked. If 
you enter a negative number followed by an 
<ENTER3>, label suffixes are decremented by that 
number when the REPEAT command is invoked. 
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Auto Increment Place 


When Auto Increment Place is enabled, label names 
are automatically incremented or decremented when 
they are entered on the worksheet with PLACE Label 
Place. After a label has been placed, the numeric suffix 
of that label is changed by the amount specified by the 
Label Repeat Delta command. 


When you select Auto Increment Place, DRAFT lets 
you choose between Yes and NO. Yes enables the 
automatic incrementing or decrementing of labels; No 
disables it. 


4.15.14 SET Visible Lettering 


You can choose to have some items on appear visible in 
Zoom scale 2. When you select Visible Lettering, the 
following menu appears: 


Part FieldPin Number 
Pin Name 

Text 

Module Port 

Power Value 

Sheet Name 

Sheet Net 

Title Block 


To make an item visible, select it and choose Yes. To 
make it invisible, select it and chose No. Note that this 
option only affects how parts appears on the screen in 
Zoom scale 2. 
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4.16 TAG 


The Tag command identifies and remembers locations 
on the worksheet that are specified by the cursor. You 
can specify eight locations (A through H) and use them 
as destinations for the jump command. Each tag is 
invisible when set on the worksheet and is not saved 
with the worksheet. 


To set a tag, place the cursor at a location that you want 
to remember. Then select the Tag command. DRAFT 
returns: 


A Tag 
B Tag 
C Tag 
D Tag 
K Tag 
F Tag 
G Tag 
H Tag 


When the subcommand menu appears on the screen 
select the tag you want from the menu. Once selected, 
DRAFT remembers the tag location. Once the tag is 
set, DRAFT returns you to the main command menu. 


EXAMPLE: 
1F Place the cursor at a location on the worksheet. 


2. Select the tag command from the main command 
menu. 


3. Select tag A from the subcommand menu. 
4. Tag location Ais now remembered. When Tag A 


is selected from the jump command, the cursor 
returns to that location. 
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For more information on the JUMP command, refer to 
Section 4.9, The Jump Command 
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4.17 ZOOM 


Zoom enables you to zoom in or out from the worksheet, 
changing the amount of detail that you see on the 
screen. You can select five zoom levels, described below. 


Scale 1 This most detailed zoom scale is the 
default. 
Scale 2 The second most detailed zoom scale that 


represents 1/2 of scale 1. 


Scale 5 The third most detailed zoom scale that 
represents 1/5 of scale 1. 


Scale 10 The fourth most detailed zoom scale that 
represents 1/10 of scale 1. 


Scale 20 The least detailed zoom scale that 
represents 1/20 of scale 1. 


To change the zoom scale select zoom. DRAFT returns: 


Center 
In 

Out 
Select 


4.17.1 ZOOM Center 


When selected, the ZOOM center subcommand re- 
centers the displayed portion of the sheet around the 
cursor. This subcommand is useful for centering an 
object on the screen so you can easily edit it. 


For example: If an object is displayed partially off the 


screen, you may center it by placing the cursor near the 
object and selecting ZOOM Center. 
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The number in parentheses shows the current zoom 
scale (1-20). 


4.17.2 ZOOM In 


The ZOOM in subcommand enables you to zoom in on 
the worksheet for a more detailed view. The number in 
parentheses shows you what the zoom scale will be the 
next time you invoke ZOOM in. 


4.17.3 ZOOM Out 


The ZOOM out subcommand enables you to zoom out 
to display a larger worksheet area. The number in 
parentheses shows you what the zoom scale will be the 
next time you invoke ZOOM out. 


4.17.4 ZOOM Select 


The Select subcommand enables you to select any one of 
five zoom scales from a pop-up subcommand menu. 
When invoked, you can select zoom scale 1, 2, 5,10, or 
20 from the menu. 
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In Section 3 you were introduced to the three types of 
file structures used to create schematics with 
OrCAD/SDT III. These are: flat file, hierarchy, and one 
sheet file structures. 


The flat file structure is the traditional method for 
creating a complex design that contains many 
worksheets. Each flat file design must be created as a 
collection of one sheet schematics. This is not only time 
consuming, but it also becomes an unmanageable task 
as the number of worksheets increases in your design. 
In a flat file design, you have to keep track of all 
worksheet file names. 


In a hierarchy, each individual file name is maintained 
by DRAFT. Each worksheet is organized as a block, or 
sheet symbol, which contains part of the design. These 
sheet symbols can contain progressively more detail 
and may be used in multiple instances to replicate 
common circuit functions. Hierarchy not only makes 
the design process easier, but it also provides the 
framework necessary to keep the design more 
manageable. Many of the benefits of a hierarchical 
design over a flat file are listed below and will be 
discussed in detail throughout this section. 


e Files are easier to manage 
¢ Worksheets may be used repetitively in the design 
¢ Utility programs are easier to implement 


e¢ Designs are created faster and easier 
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The introduction to hierarchical file structures begins 
by introducing you to the elements of hierarchical 
design. This follows with a discussion of the two types of 
hierarchical designs: simple and complex. Finally, you 
will learn how to create a simple and a complex 
hierarchy. 


5.1 ELEMENTS OF A HIERARCHY 


In a hierarchical structure, there is one “root” 
worksheet. This is the first level in the hierarchy. By 
using the PLACE Sheet command, individual blocks 
are placed in the root worksheet. These blocks are 
known as "sheet symbols" and they represent separate 
unique worksheets. To display each sheet symbol as a 
worksheet, just place the cursor inside the sheet symbol 
boundary and execute the QUIT Enter command. This 
places you one level down in the hierarchy. 


When you enter a sheet symbol, the worksheet that 
represents that sheet symbol appears on the screen. If 
other sheet symbols are placed in the worksheet and 
you continue to enter them, another worksheet will 
appear on the screen. This hierarchical procedure can 
continue to a depth of over 200 levels with OrCAD/SDT 
ITI. 


Connections between sheet symbols are made through 
"nets" that are placed along the left and right sides of 
the sheet symbol. When a sheet symbol is placed, nets 
are added to a worksheet using the "Add" subcommand. 
As in a flat file structure, module ports are used in a 
hierarchy to label signals that leave a worksheet. Ina 
hierarchy, "nets" in the sheet symbols make "implied" 
connections to similarly named module ports that are 
placed in the actual worksheet. 


For example, the nets, named XYZ, A[0..7], B[0..15], and 
C[0..3] in Figure 5-1, connect the CPU, I/O, and 


5-2 


Schematic Design Tools Hierarchy 


MEMORY sheet symbols together. Once you "enter" a 
sheet symbol to get to the corresponding worksheet, 
module ports are used to connect signals that leave the 
worksheet. These module ports make the implied 
connection (they are not actually connected with 
physical wires or buses in the schematic) to the 
similarly named nets, located in the sheet symbol. For 
example, the XYZ net in the CPU sheet symbol, would 
connect to a module port named XYZ (not illustrated) 
located in the actual CPU worksheet. 


NOTE 


We recommend that you refer to NETLIST 
in Section 6, for more information on many 
of the subjects discussed here. 
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Figure 5-1. A Root Worksheet with Three Sheet 
Symbols 


Listed below are many of the terms and definitions that 
are used in creating a hierarchical design. As in a flat 
file structure, it is important to follow these procedures. 


5-4 


\ 
\ 
) 


Schematic Design Tools Hierarchy 


ROOT SHEET 


The "root" sheet is the first worksheet in the hierarchy. 
When loading a hierarchical file into DRAFT or 
executing a utility program, you specify the root file 
name. 


SHEET SYMBOL 


Sheet symbols are drawn in a worksheet to represent a 
separate worksheet. Figure 5-1 shows an example of 
three sheet symbols. To place a sheet symbol in a 
worksheet, use the PLACE Sheet command. 


A sheet symbol is typically assigned a "Name", which 
identifies its function. For example, the sheet symbols 
in Figure 5-1 are named CPU, I/O, and MEMORY. 
Since a sheet symbol represents a worksheet, a file 
name should also be assigned. A "Filename" is 
automatically assigned to the sheet symbol based on the 
date and time of day. The filename may be modified if 
you do not want to use the one assigned by DRAFT. For 
additional information on placing sheet symbols, refer 
to Section 5.2 on the PLACE Sheet command. 


LABELS 


As in a flat file structure, labels are important in a 
hierarchy. A label must be placed on every bus that is 
used in a worksheet. This informs the NETLIST utility 
program how many members are associated with a 
bus. Labels are placed in a worksheet with the PLACE 
Label command. Bus labels must be in the form: 


BUSNAME(O..n] 


Where BUSNAME is called the "prefix" and represents 
the name of the bus. [0..n] is called the "suffix", where n 
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represents the decimal number of the last member of 
the bus; only a zero (0) is valid in the first portion of the 
suffix ([2..n] for example, is not valid. Between the 
prefix and the suffix there must be no space. 


Typical examples are: 


ADDR(0..31] (this bus has 32 
members) 

DATAI0..15] (this bus has 16 
members) 

CONTROL[0..3] (this bus has 4 
members) 


Labels must also be used to label the individual 
members, or signals, that come from a bus. As a rule, 
you may place any number of labels on a bus signal. 
When labels are placed on signals that come from a bus, 
they must be labeled in a form that corresponds to the 
bus they come from. This form is: 


BUSNAMEx 


Where BUSNAME is the same prefix name as the bus 
label, x is a decimal number in the range of [0 - n] taken 
from the suffix of the bus label, and n represents the 
decimal number of the last member of the bus. 
Between BUSNAME and x there must be no space. 


Typical examples are: 


(this would be used to 
ADDRO label a signal that 

connects to the 

ADDR(0..31] bus above) 
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(this would be used to 
DATA13 label a signal that 

connects to the 

DATA[0..15] bus above) 


MODULE PORTS 


Any signal that leaves the worksheet must do so via a 
module port. In a hierarchical structure, the signals 
that connect to a particular worksheet do so through 
module ports. A module port may have any name 
when it is connected to a wire, a suffix is not required. 
However, when connected to a bus, a module port must 
have the same suffix as the label placed on the bus that 
it connects to. The proper form is: 


BUSNAME(0..n] 


Where BUSNAME is called the "prefix" and it 
represents the name of the bus. [0..n] is called the 
"suffix", where n represents the decimal number of the 
last member of the bus. As mentioned, when connected 
to a bus, module port suffix names must match the label 
suffix name that is placed on the bus (see Labels above). 
The prefix, can be named anything. But is good 
practice to make the entire module port name, match 
the label placed on a bus. Between the prefix and the 
suffix there must be no space. Typical examples would 
be: 


ADDR(0..31] 

DATA[O..15] 

CONTROL[0..3] 
NETS 


Nets are connections that are made from a sheet 
symbol to other objects or sheet symbols. In Figure 5-1 
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above, the sheet symbol named I/O has two nets: A[0..7] 
and C[0..3]. In this example, these nets connect to buses, 
which in turn connect to other sheet symbols. When a 
sheet symbol is placed, nets are added to a worksheet 
using the "Add" subcommand. It is important to realize, 
these nets are NOT module ports. Module ports are 
never placed in sheet symbols. 


In a hierarchy, nets make "implied" connections to 
their respective module ports. For example, in Figure 
5-1, the sheet symbol named I/O has two nets: A(0..7] 
and C[0..3]. If you enter the sheet symbol (using the 
QUIT Enter command) to obtain the I/O worksheet, 
there must also be two module ports named: A[0..7] and 
C[0..3]. 


To summarize, a net placed on a sheet symbol must 
have the same name as the module port that connects 
to it in the corresponding worksheet. 


QUIT ENTER SHEET 


The QUIT Enter Sheet command enables you to enter 
a hierarchical sheet symbol to obtain the corresponding 
worksheet. To enter a sheet symbol, select the QUIT 
Enter Sheet command from the main menu. Place the 
cursor inside the sheet symbol that you want to enter. 
Then, select the Enter subcommand. 


QUIT LEAVE SHEET 


The QUIT Leave Sheet command enables you to leave 
a worksheet and return one level up in the hierarchy to 
the sheet symbol. To leave a worksheet, select the 
QUIT Leave Sheet command from the main command 
level, then select the Leave subcommand. 
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5.2 THE PLACE SHEET COMMAND 


DRAFT helps you create hierarchical designs with 
sheet symbols. The sheet symbol, representing a 
worksheet in a hierarchy, contains net names used to 
interconnect the present worksheet and the sheet 
represented by the symbol. 


To place a sheet symbol select Sheet. Draft returns the 
menu: 


Begin Find Jump Zoom _ escape 


Select Begin, outline the area, then select End to finish 
it. DRAFT then returns the menu: 


Add Delete Edit Name filename Size Zoom 
escape 


Cursor movement is restricted to within the box walls 
of the hierarchical sheet. This enables you to place the 
cursor where you want the sheet names and nets. 


Add 

Add is used to add net connections between worksheets. 
To add a net sheet connection, place the cursor at the 
edge of the box where you want the name and select 
Add. DRAFT returns the prompt "Net Name?" Type 
the net name followed by an <ENTER>. DRAFT then 
returns the menu: 


Input Output Bidirectional Unspecified 


Select the appropriate type for your sheet connection. 
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Delete 


To delete sheet connections, place the cursor at the 
connection's location and select Delete. 


Edit 


To edit a sheet connection, place the cursor at the 
connection's location and select Edit. DRAFT then 
presents a menu that allows you to choose between 
Name and Type. 


To edit the net name, select Name. When the net name 
appears on the prompt line, press <RUBOUT> to erase 
it. Then, type the new net name and press <ENTER>. 


To edit the net type, select Type. You can then chose 
Input, Output, Bidirectional, or Unspecified. 


Name 


The Name command allows you to edit the sheet name. 
The default sheet name is a question mark (?) located at 
the top of the sheet. Typical sheet names may be 
"Memory Array" or "Dynamic RAM Refresh 
circuitry”. 


To specify a sheet name, select Name. DRAFT returns 
"Sheet Name?” followed by the current sheet name. 
Press <RUBOUT> enough times to erase the current 
name. Then, type the desired sheet name. Press 
<ENTER> to place it at the top of the sheet. 


Filename 
Filename enables you to name the file representing the 


hierarchical worksheet. DRAFT automatically 
generates a filename based on the date and time of day 
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that the sheet was created. This ensures that no two 
filenames will be the same. 


The DRAFT-generated name appears on the prompt 
line when Filename is selected. 


If you want to rename the file, select Filename and 
press <RUBOUT> enough times to erase the current 
name. Then, type the new name followed by an 
<ENTER>. 


Size 


Size increases or decreases the sheet size. When you 
select Size, DRAFT returns the menu: 


End Jump Zoom _ escape 


The cursor is automatically positioned on the lower 
right corner of the sheet. To change sheet size, move 
the cursor until you reach the desired size. Then, select 
End. 


5.3 TYPES OF HIERARCHICAL DESIGNS 


When creating a hierarchy, there are two types designs 
that you can make: a simple hierarchy and a complex 
hierarchy. Both types are created in the same manner, 
which is illustrated in examples later in this Section. 


A simple hierarchy is one in which all sheet symbols are 
unique. Any number of sheet symbols can be used in 
the design. Connectivity between sheets is made 
through nets and module ports. 


A complex hierarchy is one in which some sheet 
symbols are used multiple times in the design. This 
aspect of hierarchical organization is the ability to 
replicate blocks of common logic. This means that 
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circuitry may be placed into a worksheet, a sheet 
symbol is drawn to represent that worksheet, and that 
sheet symbol is placed in multiple instances within 
other worksheets. Like the simple hierarchy, a 
complex uses nets and module ports to connect signals 
from one worksheet to another. 


5.4 EXAMPLE OF A SIMPLE HIERARCHY 


In this Section, we will describe an example of a simple 
hierarchical design, discuss labeling, module ports, nets, 
sheet symbols, and other aspects of the design, and 
review examples on executing some of the utility 
programs. 


The example schematic discussed is a three sheet 
simple hierarchy. It is defined as a simple hierarchy 
because none of the sheet symbols are replicated and 
used in multiple instances. The root sheet is illustrated 
in Figure 5-2 below, which has the title: CMOS CPU 
DESIGN. 
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When you create a hierarchy, the first step is to create 
the first sheet, or "root". This sheet is created like any 
other schematic. For this example, the root sheet is 
given the file name: CMOSCPU.SCH. As Figure 5-2 
shows, the name of the worksheet is: CMOS CPU 
DESIGN, and appears in the title block. 


Inside of the root sheet is the design's circuitry. In this 
case, the 80C51, 82C82, and discrete components. Also 
placed in the root sheet, are two sheet symbols: POWER 
SUPPLY and CMOS MEMORY. 


These sheet symbols were placed in the worksheet — 
using the PLACE Sheet command. The CMOS 
MEMORY sheet symbol contains the worksheet in 
which the systems memory is located. The POWER 
SUPPLY sheet symbol contains the worksheet in 
which the systems power supply is located. 


When you create a sheet symbol, DRAFT 
automatically assigns it a file name based on the date 
and time of day. In this example, we have modified the 
default file names and assigned the CMOS MEMORY 
sheet symbol the file name: MEMORY.SCH. The 
POWER SUPPLY sheet symbol is assigned the file 
name: POWER.SCH. 


The CMOS MEMORY sheet symbol contains four nets: 
A(0..7], WE, BACKUP, and AD[0..7]. These nets were 
placed into the sheet symbol using the PLACE sheet 
subcommand called "Add". These nets are NOT 
module ports. Connected to the A[0..7] and AD[0..7] 
nets, are buses that have labels placed on them with the 
same name as the net that they connect to. As 
mentioned earlier and in the NETLIST utility 
description in Section 6, this labeling procedure is 
mandatory for buses. Every bus must have a label 
placed on it, in the correct format. Connected to the 
WE net is a wire that goes to the PSEN signal on the 
80C51. Last, a net named BACKUP is connected to a 
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net in the POWER SUPPLY sheet symbol having the 
same name. 


For labels and module ports, there should be no space 
between the prefix and suffix portion of the names. 


Finally, in the root sheet is a power object named +5V 
connected to a power object named VDD. This connects 
the VDD pins of the 80C51 and the 82C82 to the plus 5 
volt supply. Likewise, a power object named GND is 
connected to a power object named VSS. This connects 
the VSS pin of the 80C51 and the 82C82 to power 
ground symbols. 


After the root design is completed, the QUIT Update 
command should be used. In this example, you would be 
updating the root file name: CMOSCPU.SCH. 


The next step is to enter one of the hierarchical sheet 
symbols in the root sheet to complete the design. To do 
this, you would select the QUIT Enter Sheet command. 
Place the cursor inside the POWER SUPPLY sheet 
symbol and select the Enter subcommand. Once this is 
done, you will be inside a new worksheet to be used as 
the power supply. The completed design is shown in 
Figure 5-3 below. 
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Inside the POWER SUPPLY sheet symbol is the power 
supply circuitry. Notice the module port named 
BACKUP. This makes the "implied" connection to the 
net named BACKUP in the POWER SUPPLY sheet 
symbol of Figure 5-3 above. Electrically, the BACKUP 
module port connects to the module port of the same 
name inside the CMOS MEMORY worksheet. 


In operation, the CMOS MEMORY sheet only receives 
DC power via the module port named BACKUP. 
Power is isolated in the CMOS MEMORY worksheet, 
because the power is transferred through the module 
port (refer to the NETLIST discussion in Section 6). 


When the power supply design has been completed, the 
file should be updated before you leave the worksheet. 
You would update the file by executing the QUIT 
Update command. Once updated, you may leave the 
hierarchical sheet and return to the root by executing 
the QUIT Leave Sheet command. 


Back at the root level, the next step is to enter the 
CMOS MEMORY sheet symbol and complete the 
design. To do this, you would select the QUIT Enter 
Sheet command. Then, place the cursor inside the 
sheet symbol and execute the Enter subcommand. 
Once this is done, you will be inside a new worksheet to 
be used as the cpu's memory. The completed design is 
illustrated in Figure 5-4 below. 
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Inside the CMOS MEMORY sheet symbol is the 
memory section associated circuitry. In this worksheet 
are four module ports: A[0..7], WE, BACKUP, and 
AD(0..7]. They connect to identically named nets 
located in the CMOS MEMORY sheet symbol of 
Figure 5-4 above. 


As required, the buses that connect to module ports are 
named with labels having the same suffix name as the 
module port. In this case, module port A[0..7] connects 
to a bus labeled A[0..7]. Module port AD[0..7] connects to 
a bus labeled D[0..7] (notice that the suffix has the same 
name, but the prefix differs). 


Also required in a hierarchical design, labels placed on 
signals connecting to a bus, must have the same prefix 
name as the bus that they connect to. For example, 
labels DO through D7 correspond to the prefix of the bus 
labeled D[0..7] (the prefix is a "D" in this case). Likewise, 
labels AO through A7 correspond to the prefix of the bus 
labeled A[0..7] (the prefix is an "A" in this case). 


DC power is supplied to the CMOS MEMORY 
worksheet through the module port named BACKUP. 
As mentioned, power is isolated in this worksheet since 
the VDD power object is connected to the module port 
named BACKUP. 


Finally, a power object named GND is connected to a 
power object named VSS. This connects the VSS pins of 
the 51C68 memory devices to the power ground symbol 
that the C\S\ pins are connected to. 


When design work is completed on the CMOS 
MEMORY worksheet, it should be updated before 
leaving the hierarchy. 


This completes the discussion of a simple hierarchy. In 


the following Sections, the design will be run through 
the ANNOTATE, ERC, TREELIST, NETLIST, and 
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PARTLIST utility programs. But first, we will review 
the conditions for designing a hierarchy and outline 
other helpful suggestions. 


Helpful Design Suggestions: 


1. Thoroughly read the discussion on the NETLIST 
utility located in Section 6. 


Zz Place Labels in the correct format on all buses 
(refer to previous discussions). 


3. Place Labels in the correct format on all signals 
that connect to a bus (refer to previous 
discussions). 


4, Place module ports in the correct format, on all 
signals that go off the worksheet (refer to previous 
discussions). 


5. Do not put a blank space in any label or module 
port name. 


6. | When placing sheet symbols, use "nets", not 
module ports to connect to other sheet symbols. 


7. Do not overlap wires or buses with other wires, 
buses, or object pins. 


5.4.1. Invoking The ANNOTATE Utility On 
CMOSCPU.SCH 


After the design has been completed, it should be run 
through ANNOTATE utility program (this assumes 
that you have not manually annotated the worksheet). 
To annotate the simple CMOSCPU.SCH hierarchy, 
enter the following from the DOS command line: 


ANNOTATE CMOSCPU.SCH /M <ENTER> 
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ANNOTATE is the name of the utility, 
CMOSCPU.SCH is the name of the root worksheet of 
the hierarchy, the /M switch merges the annotation 
information into each hierarchical worksheet, 
<ENTER> refers to pressing the ENTER key 


After the utility program has completed, the worksheet 
is annotated. Next, we will run CLEANUP to check for 
any editing errors. 


5.4.2 Invoking The CLEANUP Utility On 
CMOSCPU.SCH 


The CLEANUP utility scans the worksheet and 
removes duplicate wires, buses, junctions, and informs 
you if there are any other drawing errors. To cleanup 
the simple CMOSCPU.SCH hierarchy, enter the 
following from the DOS command line: 


CLEANUP CMOSCPU.SCH <ENTER> 


CLEANUP is the name of the utility, CMOSCPU.SCH 
is the name of the root worksheet of the hierarchy, 
<ENTER> refers to pressing the ENTER key 


After the utility program has completed, the worksheet 
is cleaned up, or it has informed you of items to check 
for. Next, we will run ERC to check for any editing 
errors. 


5.4.3 Invoking The ERC Utility On CMOSCPU.SCH 


Generally, every design that you create should be 
checked for errors using the ERC utility program after 
the worksheet has been annotated and cleaned up. To 
execute the ERC utility on the simple CMOSCPU.SCH 
hierarchy, enter the following from the DOS command 
line: 
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ERC CMOSCPU.SCH ERROR.TXT /U 
<ENTER> 


ERC is the name of the utility, CMOSCPU.SCH is the 
name of the root worksheet of the hierarchy, 
ERROR.TXT is the name of a text file to send the error 
information (this is useful for examining the results of 
the utility), the /U generates a unconnected pin report, 
<ENTER> refers to pressing the ENTER key 


After the utility program has completed, all errors are 
sent to the ERROR.TXT file. To examine the file, use a 
text editor or word processing software. Examining the 
ERROR.TXT file results in the following: 


Scomeoscpursch? 
UNCONNECTED REPORT 


X= 4.50 sO a © U1g P'2 0 
X= 4.50 == 2.007 I/O Ute 2m 
X= 2.60 = 25/10) -170 U1, INTO 
= 4.50 = 25.10.'E/0 Ul P2ee 
= 2.5.60 =9 2r20.c07,0 U1, INT1 
= 4.50 ah 12 20)" 27) Dt SE 2S 
= 2.60 =r) 2.50 51/0 OL, 0 
= 4.50 HU 230K T 20 U1,P2.4 
=r 2200 = 2.40 I/0 U1,T1 
me eS) = 2.40 I/0 Ul; P255 
=” F4TSU a2 390-170 UL, E270 
#9 2,60 = 2.60 T/0 8 fo Pp <b a 6 
= 7 45.50 =or2S 60. st4O ULE 2a 
Svwes 00 F Scdumi aL? © UL,P a of 
= 2.60 m2 GO Baa Udo Pl ua 
mea LOO =e OO 17 OC U1,RD 
= 2.60 a 2590-170 ULE ITS 
= 4,50 = 2.90 I/0 U1,WR 
= 2.60 Soe D6) Om bi) Oly eS. 4 
es OU eee Sat One Oa) U1 ped oe 
= 2.60 eI S208 /O Ul /PiTs 
= 4.50 = 1322056670 U1, TXD 
ptt OO sod 3305 5/0 Ui lied 
= 4.50 = aS. 30.170 U1, RXD 


WARNING - POWER Supplies are CONNECTED GND <-> VSS 
WARNING - POWER Supplies are CONNECTED VDD <-> + 5V 


“POWER.SCH" 
UNCONNECTED REPORT 
X= DOF Y=" Pon Passive T1,AA 
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X= 91.90) Y=" 02 /309Passive Teer 

X= 1104 4Ys fie O0..bassive T1,AB 
“"“memory.sch" 

UNCONNECTED REPORT 

X= fe 309) Y= p27 40minput U4,A8 

X= .4430. = . 2..50 .cnput U4,A9 
shee oe OU Lr DUG U4,A10 

Katee Qh 3 OV eyes 2-701 nput U4,Al11 

Matt 49090 Ye. 50n Input U5,A8 

X= 4.30 Y= 4.60 Input U5, A9 

X= 42307 Yorn 47-70, Lnput US,A10 

X= 4.30 Y= 4.80 Input Uo, ate 
WARNING - INPUT has NO Driving Source U4,A8 
WARNING - INPUT has NO Driving Source U4,A9 
WARNING - INPUT has NO Driving Source U4,A10 
WARNING - INPUT has NO Driving Source U4,A11 
WARNING - INPUT has NO Driving Source U5,A8 
WARNING - INPUT has NO Driving Source US,A9 
WARNING - INPUT has NO Driving Source U5,A10 
WARNING - INPUT has NO Driving Source US,A11 
WARNING - POWER Supplies are CONNECTED VSS <-> GND 
Discussion: 


The ERC program checks for a number of problems 
associated with a design. This includes: open input pins, 
shorts, and bus contention. 


A warning is issued to inform you of certain conditions 
that may be overlooked when creating your design. 
They are not critical errors. In this example, most of 
the warnings inform you of inputs with no driving 
source. This is perfectly acceptable, since we 
intentionally left these pins open in the design. The 
connected power supply warnings are also acceptable, 
since they were intended to be connected in the design. 


If you obtain ERRORS in a ERC output, they should be 
corrected before continuing on and running other 
utility programs. 


In this example, all warnings are acceptable and other 
utilities may be run. 
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5.4.4 Invoking The TREELIST Utility On 
CMOSCPU.SCH 


To obtain a text file tree list of a hierarchy, use the 
TREELIST utility. This program is helpful in 
organizing a hierarchy that contains many 
worksheets. To execute the TREELIST utility on the 
simple CMOSCPU.SCH hierarchy, enter the following 
from the DOS command line: 


TREELIST CMOSCPU.SCH TREE.TXT 
<ENTER> 


TREELIST is the name of the utility, CMOSCPU.SCH 
is the name of the root worksheet of the hierarchy, 
TREE.TXT is the name of a text file to send the tree 
information (this is useful for examining the results of 
the utility), <ENTER> refers to pressing the ENTER 
key 


After the utility program has completed, the tree 
information is sent to the TREE.TXT file. To examine 
the file, use a text editor or word processing software. 
Examining the TREE.TXT file results in the following: 


<<<Root File>>> 

[CMOSCPU.SCH] 
POWER SUPPLY 
[POWER.SCH] 
CMOS MEMORY 
[MEMORY .SCH] 


Discussion: 


All worksheet file names are enclosed within brackets 
[file names], sheet symbol names are listed above the file 
names. In this example, we see the root file has a file 
name of: CMOSCPU.SCH. Below the root, are the 
remaining sheet symbols and their associated file 
names. File POWER.SCH belongs to the sheet symbol 
named POWER SUPPLY. File MEMORY.SCH 
belongs to the sheet symbol named CMOS MEMORY. 
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5.4.5 Invoking The NETLIST Utility On 
CMOSCPU.SCH 


To obtain a netlist of a hierarchy, use the NETLIST 
utility. For this example, a CALAY net list will be 
extracted. To extract a CALAY NETLIST of the simple 
CMOSCPU.SCH hierarchy, enter the following from 
the DOS command line: 


NETLIST CMOSCPU.SCH NET.TXT CALAY 
IS <ENTER> 


NETLIST is the name of the utility, CMOSCPU.SCH is 
the name of the root worksheet of the hierarchy, 
NET.TXT is the name of a text file to send the net 
information (this is useful for examining the results of 
the utility), CALAY is the name of the desired net list 
format, /S indicates a special net list format is desired 
(CALAY in this case), <ENTER> refers to pressing the 
ENTER key 


After the utility program has completed, the net 
information is sent to the NET.TXT file. Since a 
CALAY net list format was specified, a component file is 
also generated. The component file generated has a 
CMP extension added to the NET text file. To examine 
the file, use a text editor or word processing software. 
Examining the NET.TXT file and NET.CMP file, 
results in the following: 


NET. TXT 


VNOOOOD-C2 (1) Xtal) U1L(19); 

7NOOOOS X1 (2) sCAeG14. U1 (18) ; 

/NO0003 U1(9) R2(2) Q1 (COLLECTOR) ; 
/NO0004 U2(11) U1(30); 

/NOOO005 R1(2) SW1(NO) C3(1) Q1 (BASE) ; 
/NOO006 T1(BA) D4(AC IN 1); 

/NO0007 Q2 (COLLECTOR) D4(DC OUT PLUS) R3(1) C4(1); 
/NO0008 Q2(BASE) D1(CATHODE) U3(VI); 
/NO0009 R3(2) D1 (ANODE) ; 

/NO0010 T1(BB) D4(AC IN 2); 

/NO0011 U3(GND) R4(2); 

/NO0012 BT1(+) D2 (ANODE) ; 
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/NO0013 U1(29) U4(11) U5(11); 

/GND SW1 (COMMON) Q1(EMITTER) C3(2) U2(10) U2(9) 
Cle) C2 C2) Gi (el), 
U1(20) BT1(-) C4.(2). D4(DC: OUT MINUS) 
R4(WIPER) ~R4(1)> C52)», 
U4A'S)AUS.(9)2 US LO) U4 (0 x: 

/VDD R2(1) R1(1) Q2(EMITTER) U3(VO) D3 (ANODE) 


( 

( 

(20) U1(40) U5(20) U4(20); 
/NOQ0017 U2(19) U5(8) U4(8); 
/NO0018 U2(18) U5(7) U4(7); 
/NO0019 U2(17) US5(6) U4(6); 
/NO00ZO+02 (F6)" 85-4 5) U4 05) 
/NOO0021 U2(15) U5(4) U4 ( 
/NO0022 U2(14) U5(3) U4( 
fNQO00Z3,,02 (U3) U5 (2). 04 (2) 5 
/N00024 U2(12) US(1) U4( 
/NO0025 U2(1) U1(39) U4( 
/NO00026 U2 (2 ( 
FNOOOZ 72 U2(3 
/NO0028 U2 (4 
/NO00029 U2(5 
/NO0030 U2(6) U1(34 
/NO00037:.02:(7)- GL sepeUStisy s 
FNODOS2°U21 8) “Ul (S2y"U S12) | 
/N00033 D3(CATHODE) D2 (CATHODE) ; 


NET.CMP CALAY Component text file 


10 R3 shape =xX=— MS 0 
10. UF Gs shape Se “a oe 0 
10K R2 shape ike map So 0 
12 MHZ X1 shape x shee 0 
1K R4 shape =X ‘a So 0 
1N4001 D2 shape = i 0 
1N4001 D3 shape i faa Soe 0 
Phe AS Rl shape Di a= 0 
30 PF el shape =X=- =Y- 0 
30 PF cay shape -X- -Y- 0 
4 Vv Bavl shape =x Si 0 
470 C4 shape “Pb ae 0 
470 CS shape DG SMS 0 
4:1 + bik shape =X-= 3 be 0 
51C68 U4 shape 2, NES 0) 
JLCSS US shape Nes “ke 0 
80C51 Ul shape x SP 0 
82C82 U2 shape >xX= =Y= 0 
CRO127 D4 shape =X- a8 do 0 
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IN4004 D1 shape DG eh 0 
LM123 U3 shape -X- = 0 
NPN Ql shape -X- -Y- 0 
SPST Sswl shape =X— ait 0 

0 


TIPSLC Q2 shape -X= =Y= 


5.4.6 Invoking The PARTLIST Utility On 
CMOSCPU.SCH 


To obtain a text file part list of a hierarchy, use the 
PARTLIST utility. To execute the PARTLIST utility on 
the simple CMOSCPU.SCH hierarchy, enter the 
following from the DOS command line: 


PARTLIST CMOSCPU.SCH PART.TXT 
<ENTER> 


PARTLIST is the name of the utility, CMOSCPU.SCH 
is the name of the root worksheet of the hierarchy, 
PART.TXT is the name of a text file to send the part 
information (this is useful for examining the results of 
the utility), <ENTER> refers to pressing the ENTER 
key 


After the utility program has completed, the part 
information is sent to the PART.TXT file. To examine 
the file, use a text editor or word processing software. 
Examining the PART.TXT file, results in the following: 


CMOS CPU DESIGN Revised: October 26, 
1986 
123456789 Revision: A 
Bill Of Materials October 26, 1986 ES51 249 
Page 1 
Item Quantity Reference Part 
1 al X1 12 mHz 
2 Z Clie 30a ps 
3 nL On NPN 
4 af C3 LOMUE: 
5 1 Rl 2.7K 
6 2 R2 10K 
7 £ Ul 80C51 
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8 ¥ U2 82C82 
) 1 Swl SPST 
10 1 Dl IN4004 

uae 1 R3 10 

Le 2 C4,C5 470 

Ls al Q2 cle STC 
14 us R4 1K 

Ve) 1 Bo 4 V 

16 2 D2,D3 1N4001 
ry 2 U3 LM123 
18 a yg 4:1 

cS id D4 CROLZ7 
20 2 U4,U5 51C68 


5.5 COMPLEX HIERARCHIES 


As mentioned previously, a complex hierarchy is one in 
which some sheet symbols are used multiple times in 
the design. This type of hierarchical organization 
enables you to replicate blocks of common logic without 
having to create a separate worksheet. All you do is 
place the circuit to be replicated into a worksheet. 

Then, draw a sheet symbol to represent that worksheet, 
and place that sheet symbol in multiple instances 
within other worksheets. 


Creating a complex hierarchy is just as easy as 
creating a simple hierarchy. The difference between 
the two types comes when handling and executing 
utility programs. A simple hierarchy stores the 
reference designators in each worksheet. However, a 
complex hierarchy uses one or more worksheets 
multiple times. Therefore, you cannot store the 
reference designators in the worksheets. In this case, 
an annotation file provides the method for storing the 
reference information in a binary format. 


The annotation file is created using the ANNOTATE 
utility program. When you use other utilities, the 
annotation file is used as the input file instead of the root 
worksheet file name. 
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5.6 AN EXAMPLE OF A COMPLEX HIERARCHY 


In this section, we will describe an example of a 
complex hierarchical design. The example begins with 
a design that has not been run through the 
ANNOTATE utility. Labeling, module ports, nets, sheet 
symbols, and other aspects of the design are discussed. 
Finally, we will review creating an annotation file and 
executing many of the utility programs. 


The example schematic discussed is a thirteen sheet 
complex hierarchy. It is defined as a complex 
hierarchy because many of the sheet symbols are 
replicated and used in multiple instances throughout 
the design. As will be demonstrated later, you are only 
required to create three separate worksheets to 
produce the thirteen sheet hierarchy. The example 
root worksheet is illustrated in Figure 5-5 below and 
called 4BIT ADDER. 
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As you examine the root worksheet, notice that there 
are four identical sheet symbols placed. They are 
named fulladd. Module ports are used to connect 
signals from the outside world to the appropriate sheet 
symbol and net. 


_ Since all four full adders are identical in their design, 
you do not have to create a separate worksheet for each 
of them in a complex hierarchy; you create one. 


By entering any one of the four full adder sheet symbols 
(QUIT Enter Sheet command), you will be inside of a 
new worksheet. This worksheet contains the design of 
the full adder which is shown in Figure 5-6 below. 
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Figure 5-6. FULL ADDER Worksheet 
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As you examine the contents of this worksheet, notice 
that there are two new sheet symbols named halfadd. 
Each one is identical. Each module port in the FULL 
ADDER worksheet is appropriately named to connect 
to the nets in the 4BIT ADDER worksheet, one level up 
in the hierarchy. 


Since the two half adder sheet symbols are identical, 
you do not have to create a separate worksheet for each 
of them in a complex hierarchy. 


Finally, by entering one of the half adder sheet symbols, 
you will be inside of a new worksheet. This worksheet 
contains the design of the half adder which is shown in 
in Figure 5-7 below. 


5-33 


WI 


Schematic Design Tools 


Hierarchy 


E sO E 3Seus[se6t “6e JaG0F50 "33720 


JBQWON hae ts 
Bw300V SJ1VH 


~ Z£006-O069 (EOS) 

E€2tz6 wO ‘“OV0QBITTH 
ooS ®3tNS 

38953S BUTT eSeG@ MS Brot 


uotTIeuOduoD swaAsks GQvdsoO 


v 


ven sosivrad 


cesta 
ven 


ven 


Figure 5-7. HALF ADDER Worksheet 
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As you examine the contents of this worksheet, notice 
that each module port in the HALF ADDER worksheet 
is appropriately named to connect to the nets in the 
FULL ADDER worksheet, one level up in the 
hierarchy. 


5.6.1 Further Discussion Of The Complex 
Hierarchy Example 


As you may have noticed, only three separate 
worksheets have been created. However, after 
examining the root worksheet, there are four separate 
full adders. Each full adder sheet symbol consists one 
full adder worksheet and two half adder worksheets. 
This results in three total worksheets for each full 
adder sheet symbol. The total number of worksheets 
for the complex 4 Bit hierarchy is 13 worksheets x 4 full 
adders + 1 for the root worksheet = 13 worksheets). 


Since a complex hierarchy uses one or more 
worksheets multiple times, you cannot store the 
reference designators in each of the repetitively used 
worksheets. In the 4 Bit Adder example, only three 
worksheets were created. For complex hierarchies, an 
annotation file provides the method for storing the 
reference information for each of the additional 
worksheets that have not been created. 


The annotation file is created using the ANNOTATE 
utility program. When other utilities are used, the 
annotation file is used as the input file instead of the root 
worksheet file name that was used in a simple 
hierarchy. 


5.6.2 Creating The Annotation File 


After the complex hierarchy design has been 
completed, it should be run through ANNOTATE 
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utility program to generate the annotation file. To 
annotate the complex hierarchy, assume that the root 
worksheet file name is: 4BIT.SCH. Enter the following 
from the DOS command line: 


ANNOTATE 4BIT.SCH 4BIT.ANN <ENTER> 


ANNOTATE is the name of the utility, 4BIT.SCH is the 
name of the root worksheet of the hierarchy, 

4BIT.ANN is the name of the annotation file, 
<ENTER> refers to pressing the ENTER key 


After the utility program has completed, an annotation 
file is generated which will be used as the source in all 
other utilities. At this point, we should run the 
CLEANUP utility. However, if you feel confident in 
your design, you may go ahead and run ERC. This is 
what is illustrated next. 


5.6.3 Invoking The ERC Utility 


To run the ERC utility program, specify the annotation 
file: 4BIT.ANN as the source. Enter the following from 
the DOS command line: 


ERC 4BIT.ANN ERROR.TXT /A/U <ENTER> 


ERC is the name of the utility, 4BIT.ANN is the name 
of the Annotation file, ERROR.TXT is the name of a 
text file to send the error information (this is useful for 
examining the results of the utility), /A signifies that the 
source is an annotation file, /U generates a 
unconnected pin report, <ENTER> refers to pressing 
the ENTER key 


In this example, the ERROR.TXT file will contain no 
errors. 
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5.6.4 Invoking The TREELIST Utility 


To obtain a text file tree list, use the TREELIST utility. 
This program is helpful in organizing a hierarchy that 
contains many worksheets. To execute the TREELIST 
utility, specify the root hierarchy file: 4BIT.SCH as the 
source - not the annotation file. Enter the following 
from the DOS command line: 


TREELIST 4BIT.SCH TREE.TXT <ENTER> 


TREELIST is the name of the utility, 4BIT.SCH is the 
name of the root worksheet of the hierarchy, 
TREE.TXT is the name of a text file to send the tree 
information (this is useful for examining the results of 
the utility), <ENTER> refers to pressing the ENTER 
key 


After the utility program has completed, the tree 
information is sent to the TREE.TXT file. To examine 
the file, use a text editor or word processing software. 
Examining the TREE.TXT file results in the following: 


<<<Root File>>> 
[4BIT.SCH] 
fulladd 
(fulladd.sch] 
halfadd 
{halfadd.sch] 
halfadd 
{halfadd.sch] 
fulladd 
(fulladd.sch] 
halfadd 
[halfadd.sch] 
halfadd 
{halfadd.sch] 
fulladd 
{fulladd.sch] 
halfadd 
{halfadd.sch] 
halfadd 
{halfadd.sch] 
fulladd 
(fulladd.sch] 
halfadd 
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{halfadd.sch] 
halfadd 
{halfadd.sch] 


Discussion: 


All worksheet file names are enclosed within brackets 
[file names], sheet symbol names are listed above the file 
names. In this example, we see the root file has a file 
name of: 4BIT.SCH. Below the root, are the remaining 
sheet symbols and their associated file names. 


5.6.5 Invoking The NETLIST Utility 


To obtain a net list of a hierarchy, use the NETLIST 
utility. For this example, a COMPUTERVISION net 
list will be extracted. To extract a 
COMPUTERVISION NETLIST, specify the 
annotation file: 4BIT.ANN as the source. Enter the 
following from the DOS command line: 


NETLIST 4BIT.ANN NET.TXT 
COMPUTERVISION /A /S <ENTER> 


NETLIST is the name of the utility, 4BIT.ANN is the 
name of the Annotation file, NET.TXT is the name ofa 
text file to send the net information (this is useful for 
examining the results of the utility), 
COMPUTERVISION is the name of the desired net list 
format, /A specifies that the source is a Annotation file, 
/S indicates a special net list format is desired, 
<ENTER> refers to pressing the ENTER key 


After the utility program has completed, the net 
information is sent to the NET.TXT file. To examine 
the file, use a text editor or word processing software. 
Examining the NET.TXT file results in the following: 
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NET.TXT 

0001 NOQO001 WZ2-61 901-4 

0002 NO0002 U2=5 Usez 

0003 NO0003 Uil=5>  U2Ze3 

0004 NOO004 W3s=4" Uz=2 

0005 NOO0005S U4=3., Ule9 

0006 NOO006 U4~2 U3=-6 

0007 NOOO007 UL=10. U2—4ar 

0008 NOO008 U3+85,UZ=13 

0009 NOO009 U4=11° Use 

0010 NOO0010 Us—13) 3-10 

0011 NOOO11 Us-=2 U4-8 

0012 NO0012 U3—-12 U4ed0 

0013 NO0013 Uors 06-4 

0014 NO0014 Use lO Ur=Z 

0015 NOO015 UG=5 | US-6 

0016 NOO0016 UlHAr 5 =5 

0017 NOO017 Y8-6neUeG>i2 

0018 NOO0018 US=5e wUi-6 

0019 NOO0019 Ye=-23.) US=3 

0020 NO0020 UL=8 - U8rZ 

0021 NOO0021 US srr 01 0S 

0022 NO0022 USS 2103-10 

0023 NO00023 ILO Ze 08 = 1 

0024 NO0024 a ep Me aprten, t b 

0025 NO0025 U9 S21 BU LO =o 

0026 NO0026 US=1348e012=2 

0027 NOO0027 U10-108 509-8 

0028 NO00028 Uiz-4 US=10 

0029 NO0029 Uit=-8. 10-12 

0030 NO0030 Ud es FOS ULZ=6 

0031 NO0031 DLO0Ssh3o  VIlb+6 

0032 NO00032 Vie. Ui Les 

0033 NO00033 ULU=35 ULL ie 

0034 NO0034 o= TO +" F9=6 

0035 NO0035 Ulets nOSe14 

0036 NO0036 Uia2r UA-6 

0037 NO0037 Die UL=6 

0038 NO0038 eet Ogee U2so ) U3 
0039 NO0039 U1 412 10548 

0040 NOO0040 U3e1d mUa=9eUS31 U6-6 
0041 NO0041 UG=9 _ Ue-s 

0042 NO0042 OTe, Us-~L, Yow. ULO=3 
0043 NO0043 OL0S44 Uill=3 

0044 NO0044 Uieeie (Uso 0 si t<1UL0=0i 
0045 CIN UZ—1OO.03=37 Uz =4 
0046 XO aoe ao 
0047 SO uUl=6 

0048 Xl Uorts2 UT=35, 059 
0049 X2 US=5° 907-13" U9=1 
0050 NOO0050 UES io ae om Ls (U4=12 
0051 X3 Uit-i oy UlLZ-9. Ul2=9 
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0052 S1 U6-3 

0053 NO0053 U1l-11 U8-10 U7-9 vU8-4 

0054 s2 U6-11 

0055 NOO0S5 U6-8 Ul1-2 U12-3 vU9-12 

0056 YO U3-5 U2-12 U4-4 

OUS7ay. U7-1 U5-4 US-12 

0058 S3 U10-8 

0059 x2 U7-11 U8-12 U9-4 

0060 x3 U12-5 U11-4 U11-12 

0061 COUT U10-6 

0062 VCC U1l-14 U2=-14 U3-14 U4-14 
U5-14 U6-14 U7-14 U8-14 
U9-14 10-14 U11-14 U12-14 

0063 GND U1-7 U2-7 U3-7 U4-7 
U5-7 U6-7 U7-7 U8-7 
U9-7 U10-7 U11-7 U12-7 

5.6.6 Invoking The PARTLIST Utility 


To obtain a text file part list, use the PARTLIST utility. 
To execute the PARTLIST utility, enter the following 
from the DOS command line: 


PARTLIST | 4BIT. ANN PART DXT a/% 
<ENTER> 


PARTLIST is the name of the utility, 4BIT.ANN is the 
name of the annotation file, PART.TXT is the name of 
a text file to send the part information (this is useful for 
examining the results of the utility), /A signifies that the 
source is an annotation file, <ENTER> refers to 
pressing the ENTER key 


After the utility program has completed, the part 
information is sent to the PART.TXT file. To examine 
the file, use a text editor or word processing software. 
Examining the PART.TXT file, results in the following: 
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4BIT ADDER Revised: October 27, 1986 
Revision: 
Bail Of Mater zals October 29,0 1986, 1:05:29, Page 2 


Item Quantity Reference Part 
1 3 UL, U6, ULO 74LS32 
2 6 WZFUAy US AUS mU Sy Ulead: 74LS08 
3 3 U3, Ur, OLZ 74LS04 


5.6.7 Invoking The PRINTALL Utility 


To obtain a print out on your printer, use the 
PRINTALL utility. To execute the PRINTALL utility, 
enter the following from the DOS command line: 


PRINTALL 4BIT.ANN /A/S <ENTER> 


PRINTALL is the name of the utility, 4BIT.ANN is the 
name of the annotation file, /A signifies that the source 
is an annotation file, /S outputs in scale mode, 
<ENTER> refers to pressing the ENTER key. 


Now it is time to take a break, while PRINTALL 
outputs all thirteen worksheets to the printer. Each of 
the worksheets are illustrated in the following figures. 
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Figure 5-9. 
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Figure 5-10. 
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Figure 5-11. 
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Figure 5-12. 
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Figure 5-13. HALF ADDER Worksheet 
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Figure 5-14. HALF ADDER Worksheet 
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Figure 5-15. 
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Figure 5-16. 
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NS: 6. UTILITIES 


This section describes the utility programs supported by 
OrCAD/SDT III, including: 


ANNOTATE 
BACKANNO 
CLEANUP 
CROSSREF 
ERC 
LIBARCH 
LIBLIST 
NETLIST 
PARTLIST 
PLOTALL 
PRINTALL 
TREELIST 


6.1 UTILITY PROGRAM FORMAT NOTATION 


The following notation is used to describe the utility 
programs and the parameters passed to them. 


Words shown in CAPITAL letters are program names 
and are to be entered as shown. When entering, case is 
not important since DOS converts lowercase letters to 
uppercase. 


Items shown in italics are parameters you supply to the 
program. For example, the names of source and 
destination files are parameters. 


A switch is a/ character followed immediately by a 


letter. There must be no spaces or other characters 
between the / and the letter. The letter may be either 
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uppercase or lowercase. Switches may be entered in 
any order on the invocation line. 


Items in square brackets [ ] represent parameters 
which are optional. When you include this optional 
information, do not include the square brackets when 
you enter the parameter. 


A source path may be one of three different types: 


1. The path name to the root sheet of a hierarchical 
organization of sheets. 


2. The path name of the annotation file created by 
the ANNOTATE program. 


3. The path name of a text file which consists of a list 
of sheet path names. Each sheet path name must 
be either separated by a space or tab or be on 
different lines. 


The WORKSHEET PREFIX specified in the 
configuration of OrCAD/SDT III will be used as the 
prefix of the sheet path names in items 1 and 3 above. 
This prefix may be overridden by placing a drive 
designation or a back slash at the beginning of the path. 
For example, FILE.SCH will be prefixed by the 
WORKSHEET PREFIX while A:FILE.SCH and 
\FILE.SCH will not be prefixed. When overriding, the 
name must be a valid and complete DOS path name. 


Additionally, when overriding a root sheet path name of 
a hierarchical organization of sheets, only the root sheet 
path name will be overridden. All sheets scanned will 
use the WORKSHEET PREFIX and the file name 
specified for that sheet. 
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6.2 INVOKING UTILITY PROGRAMS. 


The OrCAD/SDT III utility programs are all post 
processing, meaning that they are invoked from DOS 
after you have abandoned from your worksheet editing 
session. 


How you invoke a utility program depends on the type 
‘of file structure that you created your worksheet. 
These file structures are: 


e Hierarchy file 
e Flat file 
¢ One sheet file 


Invoking a utility program on a hierarchy file 
structure will differ slightly from invoking a utility 
program on a flat or a one sheet file structure. 
Examples for invoking each file structure are given in 
each of the specific utility program sections. Outlined 
below, is a brief overview on invoking utility programs 
for each of the types of file structures. Refer to Section 
3.11 for more information on file structures. 
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6.2.1. Invoking Utility Programs On Hierarchy File 
Structures 


To invoke utility programs on hierarchical file 
structures, enter the name of the utility program 
followed by the worksheet file name from the DOS 
command line. For example: You have created a 
hierarchical worksheet with a root file name called 
COMPUTER.SCH. The hierarchy has three 
additional hierarchical sheets referenced in 
COMPUTER.SCH with the file names CPU.SCH, 
IO.SCH, and MEMORY.SCH. To invoke a utility, just 
enter the following from the DOS command line: 


UtilityName computer.sch [optional 
parameters] 


Where UtilityName is the name of the utility program 
computer.sch is the name of the root file in the 
hierarchy, and [optional parameters] are parameters 
for the utility program such as switch options or other 
file names. 


> 


6.2.2 Invoking Utility Programs On Flat File 
Structures 


Invoking utility programs on flat file structures is 
handled slightly different than hierarchical files. A flat 
file structure is a collection of single worksheets. Since 
the worksheets do not contain references to other 
worksheet files as a hierarchy does, the flat file 
structure must contain a list of the worksheet 
filenames. 


This list is a simple text file that you create, that 
contains the names of the individual worksheets. By 
invoking a utility program on the name of the text file, 
all information is merged together into the original 
worksheets. 
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To distinguish a flat file, add the /F option switch after 
the name of the text file to be processed. This informs 
the utility program that the source is a text file, nota 
worksheet filename. 


For example: you have a flat file structure with four file 
names called SHEET1.SCH, SHEET2.SCH, 
SHEETS3.SCH, and SHEET4.SCH. To run a utility 
‘program on all of the files and merge the information 
back to each of them, place the file names in a text file. 
If you call the text file BOBSFILE.TXT, enter the 
following from the DOS command line when invoking 
a utility program: 


UtilityName BOBSFILE.TXT /F [optional 
parameters] 


Where UtilityName is the name of the utility program, 
BOBSFILE.TXT is the name of the text file, /F is the 
switch for flat file structure, and [optional parameters] 
are any parameters that may be added. Such as switch 
options or destination file names. 


6.2.3 Invoking Utility Programs On One Sheet File 
Structures 


Invoking utility programs on one sheet file structures is 
similar to that ofa hierarchical structure, except that a 
/O (Oh, not zero) option switch is added. The /O treats 
the worksheet as a single sheet schematic, not a 
hierarchy. 
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For example: your single worksheet file name is called 
ONESHEET.SCH. To run a utility program, enter the 
following on the DOS command line: 


UtilityName ONESHEET.SCH /O [optional 
parameters] 


Where UtilityName is the name of the utility program, 
/O treats the worksheet as a one sheet file structure, 
and [optional parameters] are any parameters that 
may be added. Such as switch options or destination file 
names. 


6.2.4 Two Floppy Disk System Applications 


If you configured your working floppy disks as 
recommended in Section 2, many of the utility 
programs will reside on the DRAFT disk. The DRAFT 
disk should be placed in drive A and the 
DRIVER/LIBRARY disk placed in drive B. 


When invoking a utility program on a dual floppy 
system, enter the /E option switch after the file name. 
The /E switch will display the message "Type Any Key 
To Continue", enabling the system to pause for you to 
remove the DRIVER/LIBRARY disk in drive B and 
insert the SHEET disk. 


For example, from the DOS command line enter: 
UtilityName filename /E [optional parameters] 


where UtilityName is the name of the utility program, 
filename is the name of your worksheet file, /E enables 
the system to pause for you to switch disks, and 
[optional parameters] are any parameters that may be 
added. Such as switch options or destination file names. 


Schematic Design Tools ANNOTATE 


6.3 ANNOTATE 
Purpose: 


Scans a hierarchy, flat file, and one sheet file 
structure and automatically updates all reference 
designators of library parts that are placed in the 
worksheet. This includes updating the 
corresponding pin numbers that are associated 
with a particular instance of a part with multiple 
devices in the package. 


The results of the program can be placed into either an 
annotation destination file to be used by other utility 
programs or can be placed directly into the sheets being 
scanned using the /M switch. 


See Figure 6-1 for an illustration of a worksheet that 
has not been run through the ANNOTATE utility 
program, and Figure 6-2 for a worksheet that has been 
annotated. 


Format: 


ANNOTATE source [destination] 
V/CI/DIVEI/FI/MI/ON/Q) 


Remarks: 


The source may be either the root sheet name of a 
hierarchical File structure, the name of a text file 
in a flat file structure, or the file name of a one 
sheet file structure. 


Ifthe source is the name of a text file in a flat file 
structure, the /F switch must be included. Ifthe 
source is the file name of a one sheet file 
structure, the /O switch must be included. 


The destination is any valid DOS path name and 
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is where the output of the program is to be placed. 
The ANNOTATE utility program does not 
process an annotation file. The destination must 
be included on the command line unless the /M 
switch is specified. The destination path name is 
any valid DOS file path name. 


ANNOTATE updates reference designators in 
the order they were placed in the worksheet. Any 
object that has its reference designator manually 
edited, will be assigned a new reference 
designator when the worksheet is annotated. If 
you want to selectively change reference ; 
designators, and leave others unmodified, use the 
BACKANNO utility program. 


The /C switch causes the configuration menu to be 
invoked. This allows the OrCAD/SDT III environment 
to be modified. 


The /D switch causes ANNOTATE to descend into 
parts defined as sheetpath parts. That is, you can think 
of the utility as treating a sheetpath part as sheet 
during its operation. 


The /E switch causes the utility program to display the 
message “T'ype Any Key To Continue", enabling the 
system to pause for you to remove the 
DRIVER/LIBRARY disk in drive B and insert the 
SHEET disk. This switch is used only on systems with 
two floppy disk drives. 


The /F switch causes the ANNOTATE program to read 
the source as a text file, for flat file structure 
applications. 


The /M switch causes the annotation information to be 


merged directly into the source instead of a separate 
annotation file. This switch may be specified for flat file 
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structures as well as hierarchical and one sheet file 
structures. 


If a COMPLEX hierarchy is being merged (refer to 
Section 5 for a definition of a COMPLEX hierarchy), 
only the last instance of a multiple referenced sheet will 
be retained. It is recommended that this switch not be 


‘used for COMPLEX hierarchies for this reason. If the 
_ /M switch is not specified, then the annotation file will 


be written to the destination specified at invocation. 


The /O switch causes the file name of the source to be 
read as a one sheet file structure. 


The /Q switch causes the ANNOTATE program to run 
"quietly". This means that only the invocation messages 
and error messages, if any, are displayed. If this switch 
is not specified, the program will display ntermediate 
tracking activity. 


6.3.1 Invocation Examples Using Hierarchical 
Structured Files 
1. To annotate a hierarchical schematic and merge 


the annotation information into the original 
sheets: 


ANNOTATE root.sch /M 


where root.sch is the path and name of the root 
sheet in the hierarchy and /M merges the 
information into hierarchical sheets 


2 To annotate a hierarchical schematic and direct 
the output of the ANNOTATE program to an 
annotation file: 


ANNOTATE root.sch annotation.out 
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where root.sch is the path and name of the root 
sheet in the hierarchy and annotation.out is the 
path and file name to place the annotation 
information 


6.3.2 Flat File Structure Invocation Example 


To annotate a flat file structure and merge the 
annotation information into the original sheets: 


ANNOTATE flatfile.txt /F /M 


where flatfile.txt is a text file containing a list of 
schematic file names to be scanned, /F is used to 
signify that flatfile.txt is a text file, and /M merges 
the information into flatfile.txt 


6.3.3 One Sheet File Structure Invocation 
Example 


To annotate a single sheet schematic and merge the 
annotation information into the sheet: 


ANNOTATE sheetname.sch /O /M 


where sheetname.sch is the name of the single 
sheet schematic, /O is used to signify that 
sheetname.sch is a single sheet schematic, and /M 
merges the information into sheetname.sch. 


6-10 


a 
g 
A 
& 
g 
a 
o 
B 
ae) 
E 
g 


ui 3 JS QUEAON F-) 


too-so0troset Vv 
YEQUAN 3UEeWNDZ00|EztIS 
HSLLIWSNVYHL ZHW GE 


Stati 


€etze U0B8I0 “OJOGQST{ttH 
00S FP3tNS “3S BUTteseqg MS GrOt 


uotwzevoduoD swayASstks Gvdo4soO 


69g 3d 02 


F = eu 29 
3d oot sq oet 
29 2o 
ZHW S’E Me OS's 40 O7¢ 
all 29 
Hw G‘2 
2044 


4euwwerii Noe 


M22 ova 9 UG. CAE: 
2u an oe 
6SeEGN2e@ 
2o asds 
cS 
3GAN Ce+ = 
VItva 
wuo @ vexesds nla 
Lee } 
An O°-e@ 
eds 27’ 29 


Unannotated Worksheet 


Figure 6-1. 


6-11 


Schematic Design Tools 


ANNOTATE 


8 too-s9s0togset 
A3uN YBQUNN JUeWNIZOGIeztTsS 
BHSLLIWSNYHL ZHW S'E 


eTatL 


eetze 
OOS F3tNS “3S eUutTTeeeqg MS GrOr 


YUOTI@YODNOD SweASkSs OQvdso9o 


9trrne 
20 


ZHW G'E 


yewwtsi noe 
6yu 


6SAGN2@ 
Eo 


wuo @ veNneaeds 7 
—, oo Se 
ba Fo ! 
Ss OS 


tdS T8 69 


Annotated Version of Figure 6-1 


Figure 6-2. 


6-12 


Schematic Design Tools ANNOTATE 


6.3.4 The Annotation File 


The purpose of creating an annotation file is to store the 
reference designators of a complex hierarchy. A simple 
hierarchy stores the reference designators in each of 
the worksheets. However, a complex hierarchy uses 
one or more worksheets multiple times. In this case, 
the annotation file provides a method for storing 
reference information in binary format. 


When using other utility programs on complex 
hierarchies, the annotation file is used as the source 
instead of the root schematic. Refer to Section 5, 
Complex Hierarchies for more information. 
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6.4 BACKANNO 
Purpose: 


The BACKANNO program scans either a 
hierarchy, flat file, one sheet file structure, ora 
annotation file and updates part reference 
designators in your design. The input to the 
program, a WAS/JIS text file containing old and 
new reference designators, is used to update the 
schematic worksheets. 


Format: 


BACKANNO source was/is 
VAI/CI/DIVEI/FI/O}L/Q) 


Remarks: 


The source may be either the root sheet name of a 
hierarchical file structure, the name of a text file 
in a flat file structure, an annotation file, or the file 
name of a one sheet file structure. 


If the source is the name of a text file in a flat file 
structure, the /F switch must be included. If the 
source is the file name of a one sheet file structure, 
the /O switch must be included. If the source is 
the annotation file created by the ANNOTATE 
program, then the /A switch must be included on 
the invocation line. 


was/is is as text file containing the old and new 
reference designator pairs. The file may have 
any valid DOS path name. The format of the 
was/is file is discussed later in this Section. 
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The /A switch causes the BACKANNO program to 
read the source path as an annotation file. This will 
cause the annotation file to be updated. 


The /C switch causes the configuration menu to be 
invoked. This allows the OrCAD/SDT III environment 
to be modified. 


The /D switch causes BACKANNO to descend into 
parts defined as sheetpath parts. That is, you can think 
of the utility as treating a sheetpath part as sheet 
during its operation. 


The /E switch causes the utility program to display the 
message “Type Any Key To Continue", enabling the 
System to pause for you to remove the 
DRIVER/LIBRARY disk in drive B and insert the 
SHEET disk. This switch is used only on Systems with 
two floppy disk drives. 


The /F switch causes the BACKANNO program to 
read the source as a text file, for flat file structure 
applications. 


The /O switch causes the file name of the source to be 
read as a one sheet file structure. 


The /Q switch causes the BACKANNO program to run 
"quietly". This means that only the invocation messages 
and error messages if any, are displayed. If this switch 
is not specified, the program will display ntermediate 
tracking activity. 


6.4.1 Invocation Example Using Hierarchical 
Structured File 
To back annotate sheets in a hierarchical schematic: 


BACKANNO root.sch was/is 
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where root.sch is the path and name of the root 
sheet in the hierarchy, and was/is is the name of 
the text file containing the old and new reference 
designators 


6.4.2 Invocation Example Using A Flat File 


Structure 


To back annotate a flat file structure containing 
multiple sheets: 


BACKANNO flatfile.txt was/is /F 


Where flatfile.txt is a text file containing a list of 
schematic file names to be scanned, was/is is the 
name of the text file containing the old and new 
reference designators, and /F is used to signify 
that flatfile.txt is a text file 


6.4.3 Invocation Example Using A One Sheet File 


Structure 


To back annotate a single sheet schematic: 
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BACKANNO sheetname.sch was/is /O 


Where sheetname.sch is the name of the single 
sheet schematic, was/is is the name of the text file 
containing the old and new reference designators, 
and /O is used to signify that sheetname.sch is a 
single sheet schematic. 
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6.4.4 Back Annotating Schematics Based on an 
Annotation File : 


To back annotate schematics based on the annotation 
file information: 


BACKANNO annotation.out was/is /A 


Where annotation.out is the output from the 

' ANNOTATE program, was/is is the name of the 
text file containing the old and new reference 
designators, and /A causes the BACKANNO 
program to read annotation.out as an annotation 
file. 


6.4.5 WAS/IS File Format 


The was/is file is a simple text file that you create, in 
which you place the old and new reference designators. 
The file is not required to be delimited by a carriage 
return after each was/is entry. 


The first entry in the text file contains the old reference 
designator that you want to modify, followed by any 
number of spaces, tabs, or carriage returns. The next 
entry in the text file is the new reference designator 
value. The following is a sample of a typical was/is file 
format: 


Rl RS 
R2 R12 
R3 R7 
Gite) CL 
CIS CZ 
USC UIA 
U3B U3A 


CLEANUP Schematic Design Tools 


6.5 CLEANUP 
Purpose: 


The CLEANUP program scans either a 
hierarchy, flat file, one sheet file structure, or an 
annotation file checking for wires, buses, 
junctions, labels, module ports, and other objects 
that are placed on top of each other. 


CLEANUP removes duplicate or overlapping 
wires, buses, and junctions, and displays warning 
messages advising you of other duplicate objects. 


CLEANUP does not check for objects overlapping 
part leads, wires overlapping buses, or wire bus 
entries overlapping bus bus entries. This utility 
program should be used whenever you feel that 
there may be drawing errors in the worksheet. 
We recommend that all worksheets be checked 
with 


CLEANUP to reduce errors and warnings that 
may occur when you use other utility programs. 


Format: 


CLEANUP source [destination] 
VAI/CIV/EI/FI/GIV/ON/QI/R] 


Remarks: 
The source may be either the root sheet name of a 
hierarchical file structure, the name of a text file 


in a flat file structure, or the file name of a one 
sheet file structure. 


If the source is the name of a text file in a flat file 
structure, the /F switch must be included. If the 
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source is the file name of a one sheet file structure, 
the /O switch must be included. If the source is 
the annotation file created by the ANNOTATE 
program, then the /A switch must be included on 
the invocation line. 


The destination is any valid DOS path name and 
is where the output of the program is to be placed. 
The destination is an optional parameter and ifnot 
specified the output of the CLEANUP program is 
the console monitor. 


If you are processing a worksheet that is very 
large, the program may return the message: 
“CLEANUP will need to be repeated for this file". 
This indicates that CLEANUP has utilized the 
allocated PC memory for storing temporary 
worksheet information. If this occurs, repeat the 
CLEANUP procedure using the /R switch when 
invoking the program. 


The /A switch causes the CLEANUP program to read 
the source path as an annotation file. 


The /C switch causes the configuration menu to be 
invoked. This allows the OrCAD/SDT III environment 
to be modified. 


The /E switch causes the utility program to display the 
message "Type Any Key To Continue", enabling the 
system to pause for you to remove the 
DRIVER/LIBRARY disk in drive B and insert the 
SHEET disk. This switch is used only on systems with 
two floppy disk drives. 


The /F switch causes the CLEANUP program to read 
the source as a text file, for flat file structure 
applications. 
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The /G switch checks the entire worksheet for items 
that are placed off grid and reports them. 


The /O switch causes the file name of the source to be 
read as a one sheet file structure. 


The /Q switch causes the CLEANUP program to run 
"quietly". This means that only the invocation messages 
and error messages if any, are displayed. If this switch 
is not specified, the program will display intermediate 
tracking activity. 


The /R switch is used to repeat the CLEANUP 
procedure if a file is too large for one pass. This switch 
causes the CLEANUP program to repeat the clean up 
process on a worksheet if needed. The program will 
repeat a limited number of times to avoid looping. 


6.5.1 Invocation Examples Using Hierarchical 
Structured Files 


1 To check sheets in a hierarchical schematic: 
CLEANUP root.sch 


Where root.sch is the path and name of the root 
sheet in the hierarchy 


Zt To check a sub-sheet in a hierarchical schematic: 
CLEANUP subsheet.sch /O 
Where subsheet.sch is the path and name of the 


sub-sheet in the hierarchy, /O signifies that the 
subsheet.sch file name is a single sheet 
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6.5.2 Invocation Examples Using Flat File 
Structures 


1. To check a flat file structure containing multiple 
sheets: 


CLEANUP flatfile. txt /F 
Where flatfile.txt is a text file containing a list of 
schematic file names to be scanned, /F is used to 
signify that flatfile.txt is a text file 

2.  Tocheck one sheet in a flat file structure: 
CLEANUP sheetname.sch /O 
where sheetname.sch is the name of the single 


sheet in the flat file structure, /O is used to signify 
that sheetname.sch is a single sheet schematic 


6.5.3 Invocation Example Using A One Sheet File 
Structure 


To check a single sheet schematic: 
CLEANUP sheetname.sch /O 
where sheetname.sch is the name of the single 


sheet schematic, /O is used to signify that 
sheetname.sch is a single sheet schematic 


6.5.4 Checking Schematics Based on a 
Annotation File 


To check schematics based on the annotation file 
information: 


CLEANUP annoitation.out /A 
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Where annotation.out is the output from the 
ANNOTATE program, /A causes the CLEANUP 
program to read annotation.out as an annotation 
file. 
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6.6 CROSSREF 
Purpose: 


The CROSSREF program scans through the 
schematic files, gathers information for all parts 
used in the schematic files, and creates a cross 
reference listing that tells you where each part is 
located. The CROSSREF utility will scan either a 
hierarchy, flat file, one sheet file structure, or the 
annotation file output from the ANNOTATE 
utility. 


Format: 


CROSSREF source [destination] 
VAI/CIVFIUNIV/OI/PI/QIV/RIVSI/V] 


Remarks: 


The source may be either the root sheet name of a 
hierarchical file structure, the name of a text file 
in a flat file structure, or the filename of a one 
sheet file structure. 


If the source is the name of a text file in a flat file 
structure, the /F switch must be included. Ifthe 
source is the filename of a one sheet file structure, 
the /O switch must be included. If the source is 
the annotation file created by the ANNOTATE 
utility, then the /A switch must be included. 


By default, CROSSREF produces two output 
listings. These two listings differ in the order in 
which the parts are sorted. The first listing is 
sorted first by names, then by references. The 
second listing is sorted first by references, then by 
names. 
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The destination is any valid DOS pathname and is 
where the output of the program is to be placed. If 
a destination is not specified, the output will be 
directed to the console. 


The /A switch causes the CROSSREF program to read 
the source as an annotation file. 


The /C switch causes the configuration menu to be 
invoked. The /F switch causes the CROSSREF 
program to read the source as a text file, for flat file 
structure application. 


The /N switch causes the CROSSREF program to 
output just one listing of all parts sorted first by names, 
and then by references. 


The /O switch causes the filename of the source to be 
read as a one sheet file structure. 


The /P switch causes the CROSSREF program to 
output the XY coordinates for all parts. 


The /Q switch signals the CROSSREF program to run 
"quietly." This means that only the invocation messages 
and error messages, if any, are displayed. If this switch 
is not specified, the program will display intermediate 
tracking activity. . 


The /R switch causes the CROSSREF program to 
output just one listing of all parts sorted first by 
references, then by names. 


The /S switch causes the format of the output listing to 
be single-spaced. 


The /V switch outputs a verbose format, which causes 
the header information to be included on every page. 
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6.6.1 Example Using CROSSREF 


Figures 6-3 through 6-5 show an example of a 
schematic for al Bit Full Adder. Figure 6-3 consists of 
the top-level worksheet. It indicates two subsheets. 


Figures 6-4 and 6-5 show the two subsheets. Each 
consists of a Half Adder making up the Full Adder. 


‘The circuit illustrated in this schematic is the one used 
when constructing the cross references in Sections 6.6.2 
and 6.6.3. 
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Figure 6-3. 1 Bit Full Adder Hierarchy 
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Figure 6-4. Half Adder A 
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Figure 6-5. Half Adder B 
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6.6.2 Example Using CROSSREF with /A 


To cross reference an annotation file called 
FULLADD.ANN and place the output in a file called 
FULLADD.OUT, enter the following command: 
CROSSREF FULLADD.ANN FULLADD.OUT /A 


The file FULLADD.OUT contains two cross reference 
listings. The first is reference, then part. The second is 
part, then reference. FULLADD.OUT contains the 
following: 


1 Bit Full Adder Hierarchy (COMPLEX) Revised: March 
12, 1987Revision: APart Cross Reference Listing 
September 10, 1987 6952:58 Page 1 


Item Reference Part Sheet Filename 

1 U1A TAGSS2 af fulladd.sch 
2 U1B TALS oz 2 halfadd.sch 
5 U1C YERES SH Ss} halfadd.sch 
4 U2A 74LS04 2 halfadd.sch 
5 U2B 74LS04 2 halfadd.sch 
6 ijAle 74LS04 3 halfadd.sch 
7 U2D 74LS04 3 halfadd.sch 
8 U3A 74LS08 Zz halfadd.sch 
9 U3B 74LS08 Z halfadd.sch 
10 U3C 74LS08 2 halfadd.sch 
iil U3D 74LS08 3 halfadd.sch 
BZ U4A 74LS08 3 halfadd.sch 
a U4B 74LS08 S halfadd.sch 
1 Bit Full Adder Hierarchy (COMPLEX) Revised: 


Maxchaeli2 yaa018)7 
Revision: A 
Part Cross Reference Listing September 10, 1987 
8:52 758" Page-*l 


Item Part Reference Sheet Filename 


al 74LS04 U2A 2 halfadd.sch 
2 74LS04 U2B 2 halfadd.sch 
iS 74LS04 WAC 3 halfadd.sch 
4 74LS04 U2D gi halfadd.sch 
5 74LS08 U3A 2 halfadd.sch 
6 74LS08 U3B 2 halfadd.sch 
a 74LS08 U3C 2 halfadd.sch 
8 74LS08 U3D S halfadd.sch 
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9 74LS08 U4A $i halfadd.sch 
10 74LS08 U4B 3 halfadd.sch 
thal POLS U1A uh fulladd.sch 
ib 74LS32 U1B Z halfadd.sch 
is3 74LS32 U1C 8 halfadd.sch 


6.6.3 Example Using CROSSREF with /A, /R, /P, 
and /V 


Here is another example. This example uses the four 
switches A, R, P, and V. 


CROSSREF FULLADD.ANN FULL1.0OUT /A 
/R/P/V 


The file FULL1.OUT contains the following: 


1 Bit Full Adder Hierarchy (COMPLEX) Revised: March 12, 
O87 
Revision: A 


OrCAD Systems Corporation 
1049 SW Baseline Street 
Suite 500 

Hillsboro, OR 97123 
(503) 640-5007 


Part Cross Reference Listing September 10, 1987 8:52:58 Page 
aL 


Item Reference Part Sheet Filename > ar vi 

1 U1A 74LS32 1 fulladd.sch an 707, 2.90 
2 U1B 74LS32 Z halfadd.sch SO) ee 4.0 
3 WiC 74LS32 3 halfadd.sch 55507, 2.40 
4 U2A 74LS04 % halfadd.sch S5SG  PyeXe) 
5 U2B 74LS04 2 halfadd.sch SO 92240 
6 U2Cc 74LS04 3 halfadd.sch S230, 220 
7 U2D 74LS04 3 halfadd.sch S60) mee 340 
8 U3A 74LS08 2 halfadd.sch 47.3077, 1-80 
9 U3B 74LS08 2 halfadd.sch 2e30)2eo 2 00 
10 U3C 74LS08 Z halfadd.sch S75070 93.60 
ary, U3D 74LS08 3 halfadd.sch 43075 1.80 
iy U4A 74LS08 3 halfadd.sch as05. 31.00 
ks U4B 74LS08 3 halfadd.sch Seo Olan eS160 
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Gi7imMERC 
Purpose: 


Performs a basic electrical rules check on a group 
of schematic sheets that are specified as a source 

_ input. The ERC program will scan either a 
hierarchy, flat file, one sheet file structure, or the 
annotation file output from ANNOTATE. The 
sheets are checked for unused inputs on parts, 
unlabeled wires connected to a bus, and invalid 
connections such as two part pins defined as 
outputs wired together. 


Format: 


ERC source [destination] 
VAI/CI/DIV/EI/FI/GI/LI/OI/QI/U] 


Remarks: 


The source may be either the root sheet name of a 
hierarchical file structure, the name of a text file 
in a flat file structure, or the filename ofa one 
sheet file structure. 


If the source is the name of a text file in a flat file 
structure, the /F switch must be included. Ifthe 
source is the filename of a one sheet file structure, 
the /O switch must be included. If the source is 
the annotation file created by the ANNOTATE 
program, then the /A switch must be included on 
the invocation line. 


The destination is any valid DOS path name and 
is where the output of the program is to be placed. 
The destination is an optional parameter and if 
not specified, the output of the ERC program is 
the console monitor. 
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The /A switch causes the ERC program to read the 
source path as an annotation file. 


The /C switch causes the configuration menu to be 
invoked. This allows the OrCAD/SDT III environment 
to be modified. 


The /D switch causes ERC to descend into parts defined 
as Sheetpath parts. That is, you can think of the utility 
as treating a sheetpath part as sheet during its 
operation. 


The /E switch causes the utility program to display the 
message "Type Any Key To Continue”, enabling the 
System to pause for you to remove the 
DRIVER/LIBRARY disk in drive B and insert the 
SHEET disk. This switch is used only on floppy-based 
systems. 


The /F switch causes the ERC program to read the 
source as a text file, for flat file structure applications. 


The /G switch checks the worksheet for Parts, Sheets, 
Labels, Module Ports, and Power objects that are placed 
off grid and reports them. 


The /L switch causes the ERC program to produce a 
label report and place it in the destination file. A label 
report lists all labels and module ports that are 
connected in the worksheet. 


The /O switch causes the filename of the source to be 
read as a one sheet file structure. 


The /Q switch causes the ERC program .to run “quietly”. 
This means that only the invocation messages and 
error messages if any, are displayed. If this switch is not 
specified, the program will display intermediate 
tracking activity. 
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The /U switch causes ERC to report all unconnected 
wires and pins. This switch is useful when checking for 
overlapping wires and pins. 


6.7.1 Invocation Examples Using Hierarchical 
Structured Files 
1. To check sheets in a hierarchical schematic: 


ERC root.sch 


where root.sch is the path and name of the root 
sheet in the hierarchy. - 


Dh To check a sub-sheet in a hierarchical schematic: 
ERC subsheet.sch /O 
where subsheet.sch is the path and name of the 


subsheet in the hierarchy, and /O signifies that the 
subsheet.sch filename is a single sheet. 


ot To check a hierarchical schematic and direct the 
output of the ERC program to a file: 


ERC root.sch whatfile 


where root.sch is the path and name of the root 
sheet in the hierarchy and whatfile is the path 
and filename to place the ERC information. 


6.7.2 Invocation Examples Using Flat File 
Structures 


1. Tocheck a flat file structure containing multiple 
sheets: 


ERC flatfile.txt /F 
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where flatfile.txt is a text file containing a list of 
schematic filenames to be scanned, and /F is used 
to signify that flatfile.txt is a text file. 


To check one sheet in a flat file structure: 
ERC sheetname.sch /O 


where sheetname.sch is the name of the single 
sheet in the flat file structure, and /O is used to 
signify that sheetname.sch is a single sheet 
schematic. . 


To check a flat file structure and direct the output 
of the ERC program to a file: 


ERC flatfile.txt whatfile /F 


where flatfile.txt is a text file containing a list of 
schematic file names to be checked, whatfile is the 
path and filename to place the ERC information, 
and /F is used to signify that flatfile.txt is a text file. 


Invocation Examples Using A One Sheet 
File Structure 
To check a single sheet schematic: 


ERC sheetname.sch /O 


where sheetname.sch is the name of the single 
sheet schematic, and /O is used to signify that 
sheetname.sch is a single sheet schematic 


To check a single schematic and direct the output 
of the ERC program to a file: 


ERC sheetname.sch whatfile /O 


Schematic Design Tools 


where sheetname.sch is the name of the single 
sheet schematic, whatfile is the path and filename 
to place the ERC information, and /O is used to 
signify that sheetname.sch is a single sheet 
schematic. 


6.7.4 Checking Schematics Based on an 


Annotation File 


To check schematics based on the annotation file 
information: 


ERC annotation.out /A 


where annotation.out is the output from the 
ANNOTATE program, /A causes the ERC 
program to read annotation.out as an annotation 
file 


6.7.5 Checking for Unconnected Wires and Pins 


HE 


To check a single sheet schematic for 
unconnected wires and pins: 


ERC sheetname.sch /U/O 


where sheetname.sch is the name of the single 
sheet schematic, /U is used to signify that 
sheetname.sch is a single sheet schematic, and /O 
is used to signify a one sheet schematic 


To check a single schematic and direct the output 
of the ERC program to a file: 


ERC sheetname.sch whatfile /U/O 


where sheetname.sch is the name of the single 
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sheet schematic, whatfile is the path and 
filename to place the ERC information, /U is used 
to signify that sheetname.sch is a single sheet 
schematic, and /O is used to signify a one sheet 
schematic 


6.7.6 Typical ERC Messages and Resolutions 


Listed below, are the most common error messages 
produced by ERC and possible solutions to resolve the 
errors. 


Message: 


<<<WARNING>>> Unconnected MODULE PORT 
"ect Abs. oat Yous 


Check For: 


A bus that is not properly labeled. It must be named in 
the form: BUSNAME[0..n]. Any module port that is 
connected to a bus must also be named in the proper 
form: BUSNAME[0..n]. For further information, refer 
to the NETLIST utility in Section 6. 


Message: 


WARNING - POWER Supplies are CONNECTED .... 
<->... 


Check For: 


This may be a warning that is acceptable in your 
design. If you intentionally connected two power 
supplies together, this warning will appear. If you did 
not connect two power supplies together, this indicates 
that a potential problem may exist. 
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Message: 
WARNING - INPUT has NO Driving Source .... 
Check For: 


Again, this warning may be acceptable in your design. 
If you intentionally did not connect wires to the input 
pins of a library part, this warning will appear. 


If wires are connected to an input pin and this message 
appears, you may have two wire ends overlapping or a 
wire overlapping a part pin. Wires must be connected 
end-to-end. Run the CLEANUP utility, and check for 
wire ends overlapping part pins (CLEANUP does not 
remove these), and run the ERC utility with the /U 
option switch. 


Message: 


<<<ERROR>>> Module Port on a bus does not have a 
proper format....can not process... 


Check For: 


When a module port is connected to a bus, it must be in 
the format: BUSNAME[0..n]. For further information, 
refer to the NETLIST utility in Section 6. 


Message: 


<<<ERROR>>> Bus Label does not have a proper 
format....can not process... 


Check For: 
When a label is placed on a bus, it must be in the format: 


BUSNAME(0..n]. For further information, refer to the 
NETLIST utility in Section 6. 
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Message: 


<<<ERROR>>> Sheet Net on a bus does not have a 
proper format...can not process... 


Check For: 


This error typically results from a bus connected to a 
hierarchical sheet net. The net name must match the 
name of the bus that it is connected to. The form should 
be: BUSNAME(0..n]. For further information, refer to 
the NETLIST utility in Section 6, and Section 5 on 
Hierarchy. 


6.7.7 How ERC Determines What's an Error 


Table 6-1 summarizes the rules used by ERC when 
determining invalid connections. For example, an 
output connected to an output is an error (E) while a 
power pin connected to an I/O pin is a warning (W). 


In the table, one connection is listed horizontally, and 
the other is listed vertically. For example, if you have 
an output connected to an input, you can find out the 
ERC value by starting in the OUT column (the third 
column) and going down to the IN row (actually the 
first row). The value is a period which represents an 
acceptable connection. However, if you follow the OUT 
column down to the OUT row (the third row), you see 
an EK, which indicates an error. 


For definitions of the pin types, refer to Section 7, 
Libraries. The connections prefixed with an "m" are 
module ports. You can have four types of module ports: 
input (mI), output (mO), bidirectional (mB), and 
unspecified (mU). The connections prefixed with an "s" 
are sheet net names. As with module ports, you can 
have four types of sheet net names: input (sI), output 
(sO), bidirectional (sB), and unspecified (sU). 
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Table 6-1. The Decision Matrix Used by ERC When 


Checking a Connection 
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6.8 LIBARCH 
Purpose: 


The LIBARCH program takes all the library 
parts used in the schematic files and makes a 
single library source, an archived library, 
containing only parts which are usable for those 
schematic files. 


The LIBARCH program scans a hierarchy, flat 
file, one sheet file structure, or an annotation file 
output from the ANNOTATE program. 


Format: 
LIBARCH source [destination] [/A][/C][/FJ[/O][/Q] 
Remarks: 


The source may be either the root sheet name of a 
hierarchical file structure, the name of a text file 
in a flat file structure, or the filename of a one 
sheet file structure. 


If the source is the name of a text file in a flat file 
structure, the /F switch must be included. Ifthe 
source is the filename of a one sheet file structure, 
the /O switch must be included. Ifthe source is 
the annotation file created by the ANNOTATE 
utility, then the /A switch must be included. 


The destination is any valid DOS path name and 
is where the output, the ASCII text file describing 
the parts using OrCAD's Symbol Description 
Language, is to be placed. Ifa destination is not 
specified, the output will be directed to the console. 
If the destination is the name of an existing file, 
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LIBARCH will ask if you want to overwrite the 
existing file. 


The /A switch causes the LIBARCH program to read 
the source as an annotation file. 


The /C switch causes the configuration menu to be 
invoked. 


The /F switch causes the LIBARCH program to read 
the source as a text file, for flat file structure 
application. 


The /O switch causes the filename of the source to be 
read as a one Sheet file structure. 


The /Q switch signals the LIBARCH program to run 
"quietly". This means that only the invocation messages 
and error messages if any, are displayed. If this switch 
is not specified, the program will display intermediate 
tracking activity. 


6.8.1 Example of Using LIBARCH 


If you have a schematic files called HALFSAMP.SCH, 
and want to produce a archived library source file 
called HALF.SRC, invoke the LIBARCH utility as 
follows: 


LIBARCH HALFSAMP.SCH HALF.SRC 


The library source file HALF.SRC contains the part 
definitions for all the parts used in HALFSAMP.SCH. 
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6.9 LIBLIST 


Purpose: 


The LIBLIST program takes a library object file 
and generates an ASCII text file listing all of the 
parts in that 


Format: 


LIBLIST <library object name> [destination] 
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6.10 NETLIST 
Purpose: 


The NETLIST program scans either a hierarchy, 
flat file, one sheet file structure, or an annotation 
file and generates a netlist in a number of 
selectable formats. 


Format: 


NETLIST source [destination] [format] 
VAJ/CI/DI/EI/FI/GI/H] 
VEIVLIYMIUNI/OIWPIVQIUSI/UI/V] 


Remarks: 


The source may be either the root sheet name of a 
hierarchical File structure, the name of a text file 
in a flat file structure, or the file name of a one 
sheet file structure. 


If the source is the name of a text file in a flat file 
structure, the /F switch must be included. If the 
source is the file name of a one sheet file structure 
the /O switch must be included. If the source is 
the annotation file created by the ANNOTATE 
program, then the /A switch must be included on 
the invocation line. 


> 


The destination is any valid DOS path name and 
is where the output of the program is to be placed. 
The destination is an optional parameter and if 
not specified the output of the NETLIST program 
is the console monitor. 


While NETLIST is processing worksheets, a 


sequence of asterisks (*) and periods (.) are 
displayed on the screen. This informs you that 
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processing is currently taking place. 


The format is the name of the special file format 
that you want the net list generated in. If you do 
not specify a format, then the format defaults to 
EDIF. If you want to generate a format other 
than EDIF, refer to the /S switch option below. 


The /A switch causes the NETLIST program to read 
the source path as an annotation file. 


The /C switch causes the configuration menu to be 
invoked. This allows the OrCAD/SDT III environment 
to be modified. 


The /D switch causes NETLIST to descend into parts 
defined as sheetpath parts. That is, you can think of the 
utility as treating a sheetpath part as sheet during its 
operation. 


The /E switch causes the utility program to display the 
message "Type Any Key To Continue”, enabling the 
system to pause for you to remove the 
DRIVER/LIBRARY disk in drive B and insert the 
SHEET disk. This switch is used only on systems with 
two floppy disk drives. 


The /F switch causes the NETLIST program to read 
the source as a text file, for flat file structure 
applications. 


The /G switch checks the worksheet for Parts, Sheets, 
Labels, Module Ports, and Power objects that are placed 
off grid and reports them. 


NETLIST creates a list of off-grid items and places that 
list in a file called source.GRD. 


The /H switch removes all duplicate sheets in a complex 
hierarchy. This switch is only used when generating a 


6-44 


Schematic Design Tools NETLIST 


EDIF netlist output. The resultant netlist will be 
completely hierarchical. 


The /K switch causes modules ports (input, output, and 
bidirectional) to be specified in the FutureNet format 
with attribute value types 24, 25, and 26 respectively. 
FutureNet defines these to be Connector Pin attributes. 
Also, the names CONI, CONO, and CONB will be 
assigned in the netlist's DATA field. 


The /L switch reports all labels and module ports that 
are connected in the worksheet. NETLIST places the 
label report in a file called SOURCE.LAB. 


The /M switch causes modules ports (input, output, and 
bidirectional) to be specified in the FutureNet format 
with attribute value types 10, 11, and 12 respectively. If 
/M is not used, module ports are assigned an attribute of 
5, which FutureNet defines as a Signal Name. 


The /N switch outputs a NETLIST instead of a 
PINLIST. This switch is only used when generating a 
FUTURENET netlist output. 


For example, here is a portion of a Futurenet netlist 
constructed with the /M, /K, and /N switches. 


) 

(SYM, 13 

DATA, 2,CONI 

PIN’ VCIN, 1, +1, 10, 24, IN 

) 

(SYM, 14 

DATA, 2, CONO 

PIN; + COUT, 1,=1, 11, 25,002 
) 


The /O switch causes the file name of the source to be 
read as a one sheet file structure. 
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The /P switch outputs pin numbers instead of pin 
names in FutureNet and EDIF formats. 


The /Q switch causes the NETLIST program to run 
"quietly". This means that only the invocation messages 
and error messages if any, are displayed. If this switch 
is not specified, the program will display intermediate 
tracking activity. 


The /S switch is used to generate one of the special 
netlist formats. If the switch is not specified, the netlist 
is generated in EDIF format. Enter one of the following 
formats as listed below, along with the /S option, when 
invoking the NETLIST utility. 


APPLICONBRAVO 
APPLICONLEAP 
ALGOREX 
CALAY @ 
CADNETIX 
COMPUTERVISION 
EDIF 
EEDESIGNER 
FLATEDIF 
FUTURENET * 
INTERGRAPH 
MULTIWIRE 
PCAD 

SALT 

SPICE % 
SCICARDS 
RACALREDAC @ 
TANGO 
TELESIS 
VECTRON* 
WIRELIST 


@Creates two output files: components and nets 


%Creates two output files: nets and net map 
*PINLIST or NETLIST 
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The /V switch assigns a FutureNet compatible power 
attribute to the following pin values belonging to 


OrCAD power objects: 
Power Pin Value FutureNet Attribute 
GND 100 
+5V 101 
+12V 105 
=LQV, 106 
_ VEE 207 
Rules: 


If you are using the NETLIST utility program, 
certain rules must be observed when you create 
your schematic worksheets. In particular, you 
must properly label buses, signals, and module 
ports. Handling each of these items is discussed 
further in this NETLIST Section. 


In addition, if wires, buses, or library objects are 
placed end-to-end in the worksheet, the 
NETLIST program interprets this as a physical 
connection. This is true even if a junction is not 
placed at the meeting point. 


6.10.1 Invocation Examples Using Hierarchical 
Structured Files 


PB To obtain a netlist of a hierarchical schematic: 
NETLIST root.sch 
Where root.sch is the path and name of the root 


sheet in the hierarchy 


2 To obtain a netlist of a sub-sheet in a hierarchical 
schematic: 


6-47 


NETLIST Schematic Design Tools 


NETLIST subsheet.sch /O 


Where subsheet.sch is the path and name of the 
sub-sheet in the hierarchy, /O signifies that the 
subsheet.sch file name is a single sheet. 


oe To obtain a netlist of a hierarchical schematic and 
direct the output of the NETLIST program to a 
file: 


NETLIST root.sch whatfile 


Where root.sch is the path and name of the root 
sheet in the hierarchy and whatfile is the path 
and file name to place the NETLIST information. 


4, To obtain a netlist of a hierarchical schematic in 
CALAY format and direct the output of the 
NETLIST program to a file: 


NETLIST root.sch whatfile CALAY /S 


Where root.sch is the path and name of the root 
sheet in the hierarchy, whatfile is the path and file 
name to place the NETLIST information, CALAY 
is the desired format, /S signifies that a special 
format is desired (Calay in this example). 


6.10.2 Invocation Examples Using Flat File 
Structures 


ike To obtain a netlist of a flat file structure 
containing multiple sheets: 


NETLIST flatfile. txt /F 
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Where flatfile.txt is a text file containing a list of 
schematic file names to be scanned, /F is used to 
signify that flatfile.txt is a text file. 


2. To obtain a netlist of one sheet in a flat file 
structure: 


NETLIST sheetname.sch /O 


Where sheetname.sch is the name of the single 
sheet in the flat file structure, /O is used to signify 
that sheetname.sch is a single sheet schematic 


oF To obtain a netlist of a flat file structure and direct 
the output of the NETLIST program to a file: 


NETLIST flatfile.txt whatfile /F 


Where flatfile.txt is a text file containing a list of 
schematic file names to be checked, whatfile is the 
path and file name to place the NETLIST 
information, /F is used to signify that flatfile.txt is 
a text file 


A.  Toobtain a netlist of a flat file structure in 
RACAL-REDAC format and direct the output of 
the NETLIST program to a file: 


NETLIST flatfile.txt whatfile RACALREDAC /F 
IS 


Where flatfile.txt is a text file containing a list of 
schematic file names to be checked, whatfile is the 
path and file name to place the NETLIST 
information, RACALREDAC is the desired 
format, /F is used to signify that flatfile.txt is a text 
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file, /S signifies that a special format is desired 
(Racal-Redac in this example). 


6.10.3 Invocation Examples Using A One Sheet 
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File Structure 
To obtain a netlist of a single sheet schematic: 


NETLIST sheetname.sch /O 


Where sheetname.sch is the name of the single 
sheet schematic, /O is used to signify that 
sheetname.sch is a single sheet schematic. 


To obtain a netlist of a single schematic and direct 
the output of the NETLIST program to a file: 


NETLIST sheetname.sch whatfile /O 


Where sheetname.sch is the name of the single 
sheet schematic, whatfile is the path and file 
name to place the NETLIST information, and /O 
is used to signify that sheetname.sch is a single 
sheet schematic. 


To obtain a netlist of a single schematic in 
SCICARDS format and direct the output of the 
NETLIST program to a file: 


NETLIST sheetname.sch whatfile SCICARDS /O 
/S 


Where sheetname.sch is the name of the single 
sheet schematic, whatfile is the path and file 
name to place the NETLIST information, 
SCICARDS is the desired format, /O is used to 
signify that sheetname.sch is a single sheet 
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schematic, /S signifies that a special format is 
desired (SCICARDS in this example). 


6.10.4 Netlists Based on an Annotation File 


dye To obtain a netlist based on the annotation file 
information: 


NETLIST annotation.out /A 


Where annotation.out is the output from the 
ANNOTATE program, /A causes the NETLIST 
program to read annotation.out as an annotation 
file 


6.10.5 The Limits of NETLIST 


The size of a netlist is limited by the available system 
memory. As Netlist runs, it processes each schematic 
file separately. The limit with 640K bytes of system 
memory is 8,000 wire segments and about 2,000 to 
10,000 device pins per schematic file. This includes 
only those objects on a single sheet. 


For each sheet, if the EDIF format has been selected, 
the netlist is output and resolution of signals is not 
required. EDIF contains all of the information that is 
needed. If another format has been selected, then the 
NETLIST program saves information on any signal 
that has not been resolved (signals that go off the sheet) 
separately from those that are complete nets. This 
process is completed for each sheet in the set of 
schematic files presented to the netlister. 


After all of the sheets have been processed, the 
previously unresolved nets are combined to complete 
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the connection of signals across sheet boundaries. In 
this phase, there is a limit of about 1,000 signal names 
and a limit of about 1,000 to 6,000 total nets. For a flat 
file structure, this phase combines all sheets at the same 
time. If there is not enough memory for this phase to 
complete, then the design must be made hierarchical. 


For a hierarchical design, an incremental resolution is 
made and the limits outlined above apply to each pass of 
the resolution process. This means that a much larger 
design can be handled with the hierarchical structure 
than the flat file structure. 


6.10.6 Notes on Particular Formats 


Many netlist formats require you to follow special pin 
numbering conventions. For example, OrCAD libraries 
have some of the pin names as text. These may need to 
be converted to whole numbers, depending on the 
desired netlist format. To convert pin names to whole 
numbers, see the procedures described in the SPICE 
netlist, below. 


FUTURENET 


The FutureNet system has two connectivity output 
formats, PINLIST and NETLIST. The PINLIST 
format is a part-oriented list that lists for each pin of a 
part, the net to which the pin is attached. The 
NETLIST is a net-oriented netlist that lists for each net, 
the part pins that are attached. The NETLIST format 
is extensively sorted by FutureNet. OrCAD does not do 
all of this sorting. 


The FutureNet output is limited by the amount of 
available system memory. This is due to the 
requirement that the parts and nodes need to be cross 
referenced. The limit is approximately 8,000 parts and 
12,000 total nets. This should be enough for most 
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designs. If you are doing gate array designs and need 
additional capacity, it may be necessary to partition the 
design. Contact OrCAD or your ASIC vendor for 
additional information. It is recommended that at least 
512K bytes of memory be installed in your PC. 


This netlist format may require pin numbers instead of 
pin names in the library source file. In this case, you 
may have to modify the OrCAD supplied DEVICE.LIB 
library, as outlined below in the SPICE discussion. 


Refer the descriptions above regarding the use of the /K, 
/M, /N and /V option switches when generating a 
FutureNet netlist. 


PCAD 


OrCAD uses a subset of the full PDIF specification. As 
detailed in the PDIF specification documentation, a 
NETLIST IMPORTATION SPECIFICATION is used 
to transfer a PCB netlist into the PCAD system. The 
PCAD system is a part-oriented netlist and is limited by 
the amount of available system memory. This is due to 
the requirement that the parts and nodes need to be 
cross referenced. 


The limit is approximately 8,000 parts and 12,000 total 
nets. This should be enough for most designs. If you are 
doing gate array designs and need additional capacity, 
it may be necessary to partition the design. Contact 
OrCAD or your ASIC vendor for additional 
information. It recommended that at least 512K bytes 
of memory be installed in your PC. Part values are 
suffixed with .PRT and used as the instance filename. 


The following text contains two examples of 
transporting a netlist generated using the OrCcAD/SDT 
III NETLIST in PCAD format. Example one shows 
how the ENVIRONMENT statement of the OrCAD 
netlist can be modified to link the layering file 
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necessary for the PCAD PCB layout software. Because 
some versions of the PCAD utility software will not link 
the OrCAD/SDT III PCAD compatible netlist with the 
BINARY layering file, a second example shows how the 
OrCAD/SDT III PCAD compatible ASCII netlist file can 
be merged with an ASCII layering file. 


This netlist format may require pin numbers instead of 
pin names in the library source file. In this case, you 
may have to modify the OrCAD supplied DEVICE.LIB 
library, as outlined below in the SPICE discussion. 


Example One: Changing the netlist 
"ENVIRONMENT" statement 


The sample netlist below is an example of the standard 
header line generated by OrCAD's NETLIST utility. In 
order for an OrCAD/SDT III PCAD netlist to be 
compatible to the PCAD PCB layout software the 
header line must be modified to include a PCAD 
BINARY layering file such as the generic 'LAYS.PCB’. 


{COMPONENT OrCAD.NET {ENVIRONMENT OrCAD .SDT} 
{DETAIL {SUBCOMP 

Vlouzt La eR. ube ew 

1 ADDRESS6 

2 ADDRESSS5S 
3 ADDRESS4 
4 ADDRESS3 
5 ADDRESSO 
6 ADDRESS1 
7 ADDRESS2 
8 XNO0002 


17 ADDRESS7 
18 VDD 
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The netlist below contains a modified header line to 
which the ENVIRONMENT statement has been 
modified to replace "OrCAD.SDT" with the BINARY 
layering file "LAYS.PCB" from PCAD. 


{COMPONENT OrCAD.NET {ENVIRONMENT LAYS.PCB} 
{DETAIL {SUBCOMP 

(in 216445 ORT Wo {CN 
ADDRESS6 
ADDRESSS5 
ADDRESS4 
ADDRESS3 
ADDRESSO 
ADDRESS1 
ADDRESS2 
XNO0002 


OMAHA HWNH 


10 WR*/RD_1 
$i) 36h 
421025 1 
ik pou 
14 DO_1 
15 ADDRESS9 
16 ADDRESS8 
17 ADDRESS7 
18 VDD 
}} 
ry} 


Example Two: Merging PCAD netlist with ASCII 
layering file 


The netlist below contains an example of a layering file 
that has been converted from a BINARY file format to 
an ASCII file format using the PDIF-OUT utility 
available with PCAD. 


{COMPONENT LAYS.PCB 


{ ENVIRONMENT 

{PDIFrev 1.30} 

{Program "PC-CARDS Version 0.02"} 
{DBtype: “PC-Board™} 

{DBrev 1.00} 


{DBtime.“Oct:. 22, .1985 2e903 p.m. Pe 
LDBundatc Minis!) 
{DBgrid 1} 
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{lyrstr "PADCOM" 7 "“FLCOMP" 7 "PADSLD" 8 
WE LSOLD "mS YPADINT SY 
"FLINT" 9 "GNDCON" 10 "FLGCON" 10 
"GNDCLR"® i2)-"F LGCLR™ eZ 
"PWRCLR" 13 "FLPCLR" 13 “SLDMSK™ 14 
NRLOMSK") 14 0"DRELE" WS 
"“FLDRLE 15, “BIN wes PP BRDOUTT p40" FETARGNS 4 
"SLBOCR 46 
“DEVICE S “ATIRG® -6.. “REE DEO. 6 COMP™ 1 
"SOLDER" 2°"INTL™ 34 
} 
{USER 
{PCAD 
{Vw" 7 SON 3503} 
CLVi2 ait Oecd! 08070 10) 0102 On OO, On OOsOOF 1 0.1 
PSO 02 20s 
{Gs 50 50} 
} 
} 


{DISPLAY 
[Ly "COMP w ] 
(Ls*"SOLLO"} [Wa 15, 
(Ts y125 PUTS. ACC™] (Tol Nae SNe 
} 


{ SYMBOL 
{PIN_DEF 
} 


2 AKe: 
} 


{ATR 
{IN 
(Ord .=22 167 =327-67) 
{Tyi 255} 
} 
} 
} 
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{DETAIL 
} 


{NET DEF 
} 


{PAD STACK 
} 


{ SUBCOMP 
} 
}. 
} 


Illustrated below is an example of the modifications 
that are needed to allow the OrCAD PCAD netlist to be 
merged with the ASCII layering file. Note that the 
header line of the OrCAD PCAD netlist has been 
deleted as well as the last three (3) brackets of the 
netlist file. 


{I 2114-.PRT, U6, {CN 
1 ADDRESS6 
2 ADDRESS5S 
3 ADDRESS4 
4 ADDRESS3 
5 ADDRESSO 
6 ADDRESS1 
7 ADDRESS2 
8 XNO0002 


15 ADDRESS9 
16 ADDRESS8 
17 ADDRESS7 
18 VDD 

im 


Finally, illustrated below is an example of an OrCAD 
PCAD netlist that has been merged into an ASCII 
layering file. After the merging process is finished the 
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resultant file can be converted back into a BINARY 
formatted file by using the PDIF-IN utility available 
from PCAD. The resulting file from the PDIF-IN 
utility is ready for use with the PCAD PCB layout 
software. It should be noted here that the file name 
given in the COMPONENT statement of the ASCII 
layering file should be changed to avoid the possibility of 
overwriting the existing BINARY layering file 


WIGAN Sab CB. 
{COMPONENT LAYS .PCB 


{ ENVIRONMENT 

{PDIFrev 1.30} 

{Program "PC-CARDS Version 0.02"} 
{DBtype "PC-Board"} 

{DBrev 1.00} 


{DBt ime "Oct 1227 $9S5 ae ld 6 ee Lt 

{DBunit "MIL"} 

(DBoqaard 7) 

{lyrstr "“PADCOM" 7 "FLCOMP™ 7 “"PADSLD" S&S é 
VE RSOLDY 8) MPADIN TS \ 


“FLINT” 9 “GNDCON™ 910" ™FiLGCON” = 10 
"GNDCLR" 12 "“PLGCERYSiZ 
"PWRCLR™“ 13° “FUPCER YDS = "SLUMOn. 24 
"FLSMSK" 14. "ORI =e io 
"FLDRLL" 15 “PIN S@°°ERDOUT“ 4 "FLTARG™ 4 
"SLRSCR 6 
“DEVICE” 5S “ATTR" *peVREROeES” 6-7 COMP 1 
"SOLDER" 2)" ENT mary 

} 


{USER 
{PCAD 
{Vw 150 3350'+83 
{Lv 24 4 .0 0 0°0'0.0 0-0 GLO Se 0 0-0 et 1.0 
ATO Oh 2 1 8)y 
{Gs 50 50} 
} 
} 


{DISPLAY 

[Ly "COMP" ] 

[Ls "SOLID"] [Wd 15] 

[Ts 125] (T4."CC") [Tr 1).[tm "N"] 
} 


{SYMBOL 
{PIN_DEF 
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} 


CPC 
} 


{ATR 
{IN 
COR 2 Ot =e iGr is}, 
LP VLZ55)} 
} 
os 
} 


{DETAIL 
} 


{NET DEF 
} 


{PAD STACK 
} 


{ SUBCOMP 
{I 2114.PRT U6 {CN 
ADDRESS6 
ADDRESSS 
ADDRESS4 
ADDRESS3 
ADDRESSO 
ADDRESS1 
ADDRESS2 
XN00002 
vss 
WR*/RD_1 
deter 5 3,f51. 
T2n Dera 
Toeieet 
14 DO_1 
15 ADDRESS9 
16 ADDRESS8 
17 ADDRESS7 
18 VDD 


| 
OODMDANAYNS&WNHEP 
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SPICE: 


OrCAD can create a netlist that is larger than most PC 
based Spice programs will accept. Consult your Spice 
manual for the limits. If your PC meets the memory 
requirements of Spice, the largest Spice netlist is 
capable of being generated. This should work for all PC 
versions of Spice. 


The part value is used to pass modeling information to 
the netlist. Use the special PSPICE.LIB or SPICE.LIB 
libraries supplied by OrCAD when generating a Spice 
netlist. If you desire to modify or create your own Spice 
library, you must support the proper model pin 
numbers. To implement this, use the DECOMP or 
LIBEDIT utility programs and convert the desired 
OrCAD supplied libraries to a source file (refer to 
Section 7). Make the appropriate changes to the source 
file and recompile the modified library back to an object 
file using COMPOSER or LIBEDIT. 


All library part pin names should be changed to reflect 
the model node index. To find out the proper ordering 
node, refer to your Spice manual. 


As an example of what to change, the OrCAD supplied 
NPN transistor has the pin names defined as base, 
emitter, collector in the DEVICE.LIB library. For Spice 
to understand the nodal information, the pin names 
must be changed from base, emitter, collector; to 2,3, 
and 1 (as defined in the Spice manual). Therefore, the 
library source file for the NPN will be as follows: 
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'NPN' 

REFERENCE BOe 

{X Size =} 2 {YeSuze = 2 {Parts per Package 
=} 0 


Gi SHORT IN ee 

B2 SHORT IN ce 

Te SHORT IN Jy 

a DRO Seis a Pa ee ee # 
aE) ees eek BL agi eke "het tet os #. 
fiw 2iiress 27508 Rar. W9hsCk # 
RR, RT Tem, SPE, Te tO See # 

Niet Wl Ba Ree AY Ree eas # 
Cet fee eee. eta fe aap eae te 
OS Bora. B10 # # Arash. 
et Dod sa Oe amaren erg GF cc pe eens ones 
Or as eon ee PRE SREP ee ole 
ery ana One sacs By Beaahers taken 
(OLOPPEREEET EE EEL Dem o 
£1 1 hvmen. coders Pte 5 Sevyc 3 
Vi Wie es be Soe 3 (A Eg Te Pe 
(OBIS. Beesdenst penats Peeters ss ass 
{ ABS La 4 PRS AER PN # 
hie alo 7 Raa pera FF pe a tn teite # + # 
PEO) besten feat eae ore ores #. FHF 
Ol BOON oS Sie Irn de cae +t # # 
CS o Naan ee ts DEEPA Ht # ## 
Ge NO Week one het duct ae tHE HTH 
PAU) Weer eer Ht... HEE EEEF 


The node numbers created by OrCAD are placed ina 
.MAP file so that you may cross reference the Spice 
node numbers with the node names that you have 
specified in your schematic. 


CALAY, RACALREDAC, and VECTRON: 


The NETLIST program generates an additional 
component file when you select the CALAY, 
RACALREDAC, and VECTRON formats. CALAY and 
RACALREDAC generate a .CMP file extension and 
VECTRON generates a .PLI file extension. 


In many cases, these netlist formats also require pin 


numbers instead of pin names in the library source file. 
In this case, you may have to modify the OrCAD 
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supplied DEVICE.LIB library, as outlined above in the 
SPICE discussion. 


6.10.7 Applications of Labels 


Labels are used to connect signals together from one 
worksheet area to another without using wires or 
buses. They are also mandatory for labeling buses 
when they are placed in the worksheet. As a rule, you 
may place any number of labels on a bus or wire. 


For example, assume you have a signal labeled ABC in 
the worksheet and you would like to connect another 
object in the worksheet to the same signal. Instead of 
drawing a wire from ABC on one side of the worksheet 
to the other object, you can label each signal with a 
Label as shown in Figure 6-6. 

U1A 


74LS04 


74LS04 
Figure 6-6. An Example of Using a Label 


Labels are also used for buses. Every bus must be 
labeled for the NETLIST program to properly associate 
the bus with the individual members of the bus. 
Bus labels must be in the form: 

BUSNAME[0..n] 


Where BUSNAME is called the "prefix" and it 
represents the name of the bus. [0..n] is called the 
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"suffix", where n represents the decimal number of the 
last member of the bus; only a zero (0) is valid in first 
portion of the suffix ([2..n] for example, is not valid). 
The prefix and suffix must have no space between 
them. 


Typical examples are as follows: 


ADDR [0.). 31] (This bus has 32 members. 
DATA[O..15] (This bus has 16 members. 
CONTROLER sa (This bus has 4 members. 
A[O..90] (This bus has 91 members. 


~~ wre we w 


Illustrated below, in Figure 6-7, is an example of 
properly labeling a bus. Remember, every bus must 
have a label placed on it. 


Figure 6-7. Properly Labeling a Bus 


6.10.8 Using Labels for Bus Signals 


Labels must also be used to label the individual 
members that emanate from a bus. Signals that 
connect to a bus are intended to be associated with that 
particular bus. Therefore, they must be labeled in a 
form that corresponds to the bus they came from. For 
example, if a bus is labeled as follows: 


BUSNAME[0..9] 
Then its members are labeled as follows: 


BUSNAMEx 
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Then its members are labeled as follows: 
BUSNAMEx 


x is a decimal number in the range of [0 - 9]. 
BUSNAME and x must have no space between them. 
In general, the prefix of the bus member's label must be 
the same as the prefix of the bus's label. Also, the 
appended decimal number must be within the bus's 
range. 


An example of the use of bus and signal labels is 
illustrated in Figure 6-8. Label A[0..9] is placed on the 
bus. Labels AO through AQ are for the bus signals. 
Notice the letter Ain the labels. The prefix for the bus's 
label is the same as the prefix for each of the bus signal 
labels. 


Figure 6-8 Using Labels for Buses and Bus Members 


6.10.9 Applications of Module Ports 


Any signal that is to go off the worksheet must do so via 
a module port. In a flat file structure, all module ports 
are considered to be global. In a hierarchical structure, 
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the signals that connect to the level above a particular 
sheet do so via module port to net connection. 


In a hierarchy, the module port must have the exact 
same name as the sheet net name to which it connects 
in the sheet symbol. If the signal is a bus, then both the 
module port and the sheet net name must be of the bus 
identification format. This format for a bus connected 
to a module port is as follows: 


BUSNAME(0..n] 


Where BUSNAME is called the "prefix" and it represents 
the name of the 


bus. [0..n] is called the "suffix", where n represents the 
decimal number of the last member of the bus. The 
prefix and suffix must have no space between them. 


Typical examples are as follows: 


ADDR(0..31] 
DATA(0..15] 
CONTROLO0..3] 
A[0..200] 


When a bus is connected to a module port, in both flat 
file and hierarchical file structures, the suffix of the 
label on the bus must be identical to the suffix of the 
module port name. The prefix of the module port and 
the label on the bus may be different. Figure 6-9 
illustrates three examples of properly connecting buses 
to module ports. Notice that the bus label suffix, [0..15], 
is identical to the module port suffix. 
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ADDIO..15]) > elaine 
OUT [O..i5) > etl 


<POHT IO. as) > > = 
Figure 6-9 Connecting Buses to Module Ports 


Signals (individual wires or non-bus signals) may be 
connected directly to module ports. Module ports that 
are connected to non-bus signals may be named in any 
format. They are not required to have a suffix. Figure 
6-10 illustrates typical examples of signals that are 
connected to module ports. 

vec 


74LS04 


Figure 6-10 Connecting Signals to Module Ports 


6.10.10 Splitting Buses 


A special feature of DRAFT, enables you to split buses in 
your worksheet. Figure 6-11 illustrates how to do this. 
In this figure, the bus labeled A/D[0..15] is attached to a 
module port having the same name. Members of this 
bus are connected to U7 through the labels A/DO 
through A/D15. 
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Figure 6-11. Splitting a Bus 


To split this bus, place two new buses anywhere in the 
worksheet and label them as follows. One bus is labeled 
AL[0..7]. Signals to the bus are transferred via the bus 
signals A/DO through A/D7, which are implied 
connections to any other bus signal having the same 
names. ALO through AL7 are also labels placed on the 
bus signals. They perform the actual splitting and 
transfer the signals to the bus AL[0..7]. 


The other bus is labeled AH[0..7]. Labels A/D8 through 
A/D15 make implied connections to labels with the 
same name on the A/D[0..15] bus off U7. Labels AHO 
through AH7 split the higher address line from U7 to 
the bus labeled AH[0..7]. 


When splitting buses, do not physically connect the split 
bus members to the main bus. For example, in Figure 
6-11, do not connect the bus members A/D0O through 
A/D15 from buses AL[0..7] and AH[0..7] to the main bus 
A/D(0..15]. 
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6.10.11 Multiple Labels on a Bus 


A bus may have more than one label placed on it. In 
actual applications, bus labels may be placed anywhere 
on the bus and still be associated with their respective 
bus signal labels. 


6.10.12 Combining Labels 


Figure 6-12 illustrates an example of combining labels. 
Label MEM[0..11] is placed on the bus which contains 
12 members. U1 is connected to the bus via labels 
MEMO through MEM11. 


Notice on the left side of the figure that the label 
MEM10 has another label C\S\ placed next to it, and 
that the label MEM11 has another label W\E\ placed 
next to it. 


Also, C\S\ and W\E\ are labels that have been placed 
on pins 8 and 10 of U2 and U3. The example shows 
how to connect signals MEM10 and MEM11 to U2, by 
labeling them appropriately as C\S\ and W\E\. 


In the case of U3, the C\S\ and W\E\ signals are 
connected to the 2114 device without being physically 
connected to the bus. 


Labels MEMO through MEM9 on U2 and U8 connect 
the 2114 address lines (AO - AY) to the bus. 
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6.10.13 Connecting Bus Labels to Module Ports 


Figure 6-13 illustrates connecting bus signals to 
module ports. The main bus is labeled as BUS[0..10]. 
U1 is connected to the bus via bus members BUSO 
through BUS10. 


Signal W\E\ is transferred off the worksheet via 
module port W\E\. Since the signal is transferred 
through bus BUS[0..10], the signal must be labeled with 
BUS10. 


The R\A\S\ signal is labeled as a signal that can be 
used elsewhere in the worksheet. Because the R\A\S\ 
signal is transferred through the bus, it must also be 
labeled with a label named BUS8. You could leave the 
bus signals labeled as BUS8 and use BUS8 elsewhere in 
the worksheet, but placing another label called R\A\S 
on the bus signal is more conventional. 


Finally, bus BUS[0..10] also leaves the worksheet. It is 
connected to a module port having the same name. 
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6.10.14 Handling and Isolating Power 


Power connections are handled in a number of ways. 
Most parts in the libraries supplied by OrCAD have 
defined power and ground pins. These pins are hidden 
from the drawing, but nevertheless are part of the 
symbol definition. 


To make connections from the outside world to the 
hidden power pins in the library part, a power object is 
used (PLACE Power command). For example, assume 
that you have a CMOS device placed in the worksheet. 
This device has been defined to have a VDD and VSS 
power pin in the library source file. If you want 
another signal from the outside world connected to the 
same VDD2 potential as in the CMOS device, just 
connect that signal to a power object named VDD. 


Power objects are global. Global means that a signal 
(power in this case) connects to other signals that are 
global having the same name. This is true for any 
worksheet file structure. The NETLIST utility 
connects all similar power names and signals together. 
The power handling ability of OrCAD/SDT III, makes it 
extremely easy to isolate different power sources. 


The NETLIST program will treat certain parts in the 


library as a power object if they are defined a special 
way. The four types of grounds in the DEVICE.LIB 
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library are good examples. They are Earth, Field, 
Power, and Signal grounds. To be treated as power 
objects, a device is defined with zero parts per package 
with only one pin defined. The one pin is a PWR type, 
as illustrated below in the example of the Power ground 
symbol. When these conditions are met, the NETLIST 
program internally represents this part in the same 
manner as a power object. 


'GND POWER' 
{X Size =} 2 {Y Size =} 1 {Parts per Package =} 0 


TL PWR "GND ' 


OSH HT ETE TEE FEET HE FE FF 


{ 
{ 
{ 
{ 
{ 
ORF Dy Fe ee REY Ge dre 
{ 
{ 
{ 
{ 
{ 


In the above example, notice that the pin name is called 
GND. When a Power ground symbol is placed in the 
worksheet, NETLIST interprets this ground symbol to 
be connected to any other object that has a power pin 
named GND. 


To isolate different types of power, change the pin name 
in the library source file, or use a power object. To 
isolate grounds for example, change the pin name in 
the library source file. Rename GND in a Signal 
ground library source to SGND. Or rename GND in 
the power ground library source to PGND. The 
NETLIST will then interpret each type of ground to be 
connected with any other object that has a power pin 
defined as SGND or PGND. If you do not wish to 
modify the library, you can also use a power object. Just 
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select the PLACE command, and change the "Value" to 
be whatever is required. 


NOTE 


To find power pin numbers on library 
components, use the LIBRARY Browse 
command. 


6.10.15 Connecting Different Power Object 
Names 


In the OrCAD-supplied libraries, many of the devices 
have been defined to have VCC as the positive supply 
voltage pin. Others have VDD defined as the positive 
supply voltage pin. If you want them both to operate 
from the same power supply, you must connect them 
together. 


Likewise, many of the libraries have GND and VSS 
defined as the return power pins. If you want to have 
them connected together and be common to each other, 
you must connect them together also. 


To connect power supply pins together, or connect a 
power supply pin to any other supply voltage, you must 
place a power object for each different supply in the 
worksheet. One power object must be named the same 
as one of the supply voltages, VDD for example. The 
other power object must be named the same as the 
remaining supply voltage, VCC for example. Finally, 
the power objects that are placed in the worksheet must 
be connected together with a wire. The following 
Figure illustrates four examples. 
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Vcc Hee: AV, 
EXAMPLE A ir ? 

VCC VOD Suse A eb) 
EXAMPLE 8B 

VEE = pc 4 
EXAMPLE C 
EXAMPLE D 

VSS GND 


Figure 6-14. Power Supply Connections 


Example A illustrates a power object named VCC 
connected to a +5 volt power supply. In the netlist 
output, every object that has a VCC pin will be 
connected to a +5 volt power supply. This assumes that 
your design contains a power supply with a power 
object named +5V attached. Refer to Figure 6-16 
below. 


Example B illustrates two power objects named VCC 
and VDD connected to a +5 volt power supply through a 
power object named +5V. 


Example C illustrates a power object named VEE that 
is connected to a -5.2 volt power supply through a 
power object named -5.2V. 


Example D illustrates a power object named VDD 
connected to a power object named GND. This 
electrically connects the two types of grounds in the net 
list. 
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Figure 6-15. Power Supply with a Power Object 


6.10.16 Connecting Power Objects to a Module 
Port 


There are cases when you wish to isolate power in the 
worksheet. One way to do this would be to make all 
new parts with new power pin names. Not only would 
this be time consuming, but it would be very difficult to 
keep track of which parts are to be used on which 
schematic for any particular supply. 


Isolating power without having to create new parts is 
done by connecting a module port to a power object. 
The NETLIST program will then supersede the use of 
the power object with a module port. Only the module 
port will be passed off of a sheet to isolate circuitry used 
on another worksheet. 


If a power object is to transfer power from one 
worksheet to another, either in a flat file or hierarchical 
structure, it must be connected to an "unspecified" 
module port. Any other type of module port is not 
accepted by ERC. Three examples of connecting power 
objects to module ports are illustrated in Figure 6-16. 
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Figure 6-16. Connecting Power Objects to Unspecified 
Module Ports 


6.10.17 Considerations When Handling Power in 
a Hierarchy 


Power in a hierarchy is handled in much the same 
manner as a flat file structure. Power objects will 
connect to all other objects that have the same name. If 
a module port is connected to a power object, then the 
module port will supersede the power object in going off 
of the sheet. Note that this module port is treated the 
same as all other module ports. 


It is necessary to make a sheet net in the sheet symbol 
when passing power in a hierarchy. If a sheet net is not 
defined, the NETLIST program will not resolve the 
connections of the module port properly. 


6.10.18 Example of Isolating Power - Battery 
Backup 


A power object connected to a module port provides an 
easy way to isolate power in a design. In battery backup 
applications, main power can be supplied throughout 
the design with power objects. Backup power can be 
isolated from the main source by using a module port. 
For example, Figures 6-18 through 6-21 illustrate a 
battery backup application. 
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This design is was created as a three-sheet hierarchy. 
The root sheet, in Figure 6-17, contains the CPU and 
control circuitry of the design. Two hierarchical sheet 
symbols are also placed in the root worksheet. One 
sheet symbol represents the power supply; the other 
represents the memory that is to be battery backed up. 


Notice that a VDD power object is placed in the root 
worksheet and is connected to a +5V power object. 
Since the 80C51 and the 82C82 power pins are labeled 
as VDD in their library source files, the +5V and VDD 
power objects will connect plus 5 volts from the power 
supply (Figure 6-18) to the VDD pins in the NETLIST 
output. 
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Figure 6-17. Root CPU Sheet 
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Figure 6-19 illustrates the CMOS memory that is to be 
battery backed up. The memory control signals are 
transferred from the CPU sheet through module ports 
AD[0..7], WE, and A[0..7]. The power supplied to the 
CMOS MEMORY worksheet is isolated from the +5V 
supply through a module port labeled BACKUP. 


In the CMOS MEMORY sheet, the BACKUP module 
port is connected to a power object named VDD. The 
power object named VDD is global only to the 
worksheet that it is placed in. This means that signals 
will connect to all other signals that have the same 
name, VDD in this case. Power remains isolated from 
VDD on the CPU sheet through the use of the 
BACKUP module port. 


Notice, that a GND and VSS power object is also placed 
in the CMOS MEMORY worksheet. This connects the 
VSS power return pins from the memory devices to the 
Power ground object. 
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Figure 6-19. CMOS Memory Sheet 
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To summarize, power may be isolated in a design by 
transferring it through module ports that are 
connected to selectively named power objects that 
match the power pin names in library source files. 


Although, this design was created as a hierarchy, it also 
could have been created as a flat file structure. In 
applications where you isolate power, always place the 
circuitry to be isolated in a separate worksheet. This 
keeps the isolated power specific to one worksheet. 


6.10.19 Handling Physical Connectors 


Module ports are not intended to be used as physical 
connectors in your design. If they are used, the 
NETLIST utility has no way to connect signals to 
specific pin numbers. This is because module ports do 
not have pin numbers. Physical connectors should 
always be made as a library part, since it is desired to 
have a reference designator and part value associated 
with the connector. 


Easy-to-read schematics should refrain from 
separating individual pins in a connector and placing 
them all over the worksheet. This makes locating 
connector pins a real task, especially when multiple 
sheets are involved. It is recommended to place a 
connector in one worksheet and use module ports or 
labels to connect pins to other signals in the design. 
Figure 6-20 illustrates this below. 
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CONNECTOR DBY 


Figure 6-20. Handling Connectors 


Making large connectors with alphanumeric pin 
names can easily be handled by making the connector a 
block symbol. To make a connector with alphanumeric 
pin names, make the part with zero "0" parts per 
package. Do not use the token GRIDARRAY or "1" part 
per package. Listed below is a library source example 
of an IBM 62 pin edge connector. Because of the large 
size of the example, only a portion is shown. Since there 
are no pin numbers defined in the source file, the 
NETLIST utility uses the pin name information. In 
this example, B1 through R31 would be used as the pin 
numbers in the netlist. 


"CONNECTOR IBM' 
REFERENCE 'J' 


10 32 0 

Ll PAS ‘Buy 
L2 PAS eis 
L3 PAS "BS 
L4 PAS "B4' 
L30 PAS BO: 
L31 PAS eo 
Rl PAS La 
R2 PAS "A2' 
R3 PAS yee 
R4 PAS "AG! 
R30 PAS “aoa. 
R3I PAS “RS Lie 
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6.10.20 CONFIG.SYS File 


If you get an "MSDOS error #4 NO HANDLES LEFT", 


be sure that your computer CONFIG.SYS file has these 
parameters: 


BUFFERS=16 
. FILES=10 
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6.11 PARTLIST 
Purpose: 


Creates a summation of all parts used in a group of 
schematic sheets. The PARTLIST program will scan 
either a hierarchy, flat file, one sheet file structure, or 
the annotation file output from the ANNOTATE 
program. 


Optionally, user specific part information may be added 
in a text, or "include file". If this user specific 
information is included, then the PARTLIST program 
will output the parts found in the order that they 
appear in the include file. Any parts not in the include 
file are placed at the end of the report. 


Format: 


PARTLIST source [destination] [include] 
VAI/CI/DIVEI/FI/N/ONW/QIV/SI/V] 


Remarks: 


The source may be either the root sheet name of a 
hierarchical file structure, the name of a text file 
in a flat file structure, or the file name of a one 
sheet file structure. 


If the source is the name of a text file in a flat file 
structure, the /F switch must be included. If the 
source is the file name of a one sheet file structure, 
the /O switch must be included. If the source is 
the annotation file created by the ANNOTATE 
program, then the /A switch must be included on 
the invocation line. 


The destination is any valid DOS path name and 
is where the output of the program is to be placed. 
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If a destination is not specified, the output of the 
PARTLIST program is directed to the console. 


The include is the path name of a text file which 
contains user information to be included in the 
parts list. The format of this file is discussed later. 
This parameter is only recognized when the /I 
switch is present on the command invocation line. 
If the include file is used, you must follow the 
format illustrated above when invoking the 

’ PARTLIST program. If there are two path 
names on the invocation line, the first path name 
will be used as the source and the /I switch will 
cause the second path to be used for the include 
path. If there are three path names on the 
invocation line, then the third path will be used for 
the include path. 


The /A switch causes the PARTLIST program to read 
the source path as an annotation file. 


The /C switch causes the configuration menu to be 
invoked. This allows the OrCAD/SDT III environment 
to be modified. 


The /D switch causes PARTLIST to descend into parts 
defined as sheetpath parts. That is, you can think of the 
utility as treating a sheetpath part as sheet during its 
operation. 


The /E switch causes the utility program to display the 
message “Type Any Key To Continue", enabling the 
system to pause for you to remove the 
DRIVER/LIBRARY disk in drive B and insert the 
SHEET disk. This switch is used only on systems with 
two floppy disk drives. 


The /F switch causes the PARTLIST program to read 
the source as a text file, for flat file structure 
applications. 
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The /I switch causes the PARTLIST program to 
include user supplied information in the output. 


The /O switch causes the file name of the source to be 
read as a one sheet file structure. 


The /Q switch causes the PARTLIST program to run 
"quietly". This means that only the invocation messages 
and error messages if any, are displayed. If this switch 
is not specified, the program will display intermediate 
tracking activity. 


The /S switch causes the format of the output report to 
be single spaced rather than defaulted to double spaced. 


The /V switch outputs a verbose format, which causes 

the header information to be included on every page. 

6.11.1 Invocation Examples Using Hierarchical 
Structured Files 

1.  Tocreate a parts list of a hierarchical schematic: 


PARTLIST root.sch 


Where root.sch is the path and name of the root 
sheet in the hierarchy. 


2. To obtain a parts list of a sub-sheet in a 
hierarchical schematic: 


PARTLIST subsheet.sch /O 


Where subsheet.sch is the path and name of the 
sub-sheet in the hierarchy, /O signifies that the 
subsheet.sch file name is a single sheet. 


3. To direct the output of the PARTLIST program to 
a file: 
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PARTLIST root.sch whatfile 


Where root.sch is the path and name of the root 
sheet in the hierarchy and whatfile is the path 
and file name to place the PARTLIST 
information. 


4. To direct the output of the PARTLIST program to 
a file and include additional information: 


-PARTLIST root.sch whatfile include.txt /1 


Where root.sch is the path and name of the root 
sheet in the hierarchy, whatfile is the path and file 
name to place the PARTLIST information, 
include.txt is the name of the include text file, and 
/T signifies that a include file is specified 


6.11.2 Invocation Examples Using Flat File 
Structures 


1. Tocreate a parts list ofa flat file structure 
containing multiple sheets: 


PARTLIST flatftle.txt /F 


Where flatfile.txt is a text file containing a list of 
schematic file names to be plotted, /F is used to 
signify that flatfile.txt is a text file. 


2. Tocreate a part list of one sheet in a flat file 
structure: 


PARTLIST sheetname.sch /O 
Where sheetname.sch is the name of the single 


sheet in the flat file structure, /O is used to signify 
that sheetname.sch is a single sheet schematic. 
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3.  Tocreate a parts list of a flat file structure and 
direct the output to a file: 


PARTLIST flatfile.txt whatfile /F 


Where flatfile.txt is a text file containing a list of 
schematic file names to be checked, whatfile is the 
path and file name to place the PARTLIST 
information, /F is used to signify that flatfile.txt is 
a text file. 


4.  Tocreate a parts list ofa flat file structure, direct 
the output to a file, and include additional 
information: 


PARTLIST flatfile.txt whatfile include. txt /F /I 


Where flatfile.txt is a text file containing a list of 
schematic file names to be checked, whatfile is the 
path and file name to place the PARTLIST 
information, include.txt is the name of the include 
file, /F is used to signify that flatfile.txt is a text file, 
and /I signifies that an include file is specified. 


6.11.3 Invocation Examples Using A One Sheet 
File Structure 


1.  Tocreate a parts list of a single sheet schematic: 
PARTLIST sheetname.sch /O 


Where sheetname.sch is the name of the single 
sheet schematic, /O is used to signify that 
sheetname.sch is a single sheet schematic. 


2.  Tocreate a parts list of a single schematic and 
direct the output to a file: 


PARTLIST sheetname.sch whatfile /O 
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Where sheetname.sch is the name of the single 
sheet schematic, whatfile is the path and file 
name to place the PARTLIST information, and /O 
is used to signify that sheetname.sch is a single 
sheet schematic 


3. Tocreate a parts list of a single schematic, direct 
the output to a file, and include additional 
information: 


PARTLIST sheetname.sch whatfile include.txt /O 
/T 


Where sheetname.sch is the name of the single 
sheet schematic, whatfile is the path and file 
name to place the PARTLIST information, 
include.txt is the name of the include file, /O is 
used to signify that sheetname.sch is a single sheet 
schematic, and /I signifies that an include file is 
specified. 


6.11.4 Obtaining a Parts List from Schematics 
Based on an Annotation File 


PARTLIST annotation.out /A 


Where annotation.out is the output from the 
ANNOTATE program, /A causes the PARTLIST 
program to read annotation.out as an annotation 
file. 


6.11.5 Include File Format 
The include file is a simple text file that you create, in 
which you place additional part information. The first 


line of the file contains a header line which will be 
added to the header placed at the top of each page. 
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The header line begins with a pair of single quotes with 
no characters or space between them. The remainder 
of the line contains the header information that you 
want to include. For each part to include information, a 
separate line in the file is created which begins with the 
part name as it appears in your worksheet. The name 
must be enclosed within single quotes (such as 
‘7T4LS00'). 


After you enter the part name, place the information on 
the same line that you want to be included ("Resistor 1/4 
Watt 5%" for example). For both types of lines, header 
and part, the line will be left justified to the first non- 
space character of the information portion of the line. 
When the PARTLIST program has finished scanning 
the sheets, it then scans the include file to include the 
rest of the line after any part name that matches. The 
following is a sample of the include file format. 


of DESCRIPTION Part Order Code 
al 4 Resistor 1/4 Watt 5% 10000111003 
a2 Resistor 1/4 Watt 5% 10000114703 
aa Bs Resistor 1/4 Watt 5% 10000112204 
¥ ebe V Capacitor Ceramic Disk 10000211006 
bre dnalea: Capacitor Ceramic Disk 10000211007 
i ee Capacitor Ceramic Disk 10000211008 
* OOlut”* _Capaciecr Ceramnze pisk 10000211009 
BG LV ONO) U TTL Quad Two Input NAND Gate 10001040000 
'74LS00' TTL Quad Two Input NAND Gate 10002040000 
"74500! TTL Quad Two Input NAND Gate 10003040000 


'74ALSO0' TTL Quad Two Input NAND Gate 10004040000 
"74AS00' TTL Quad Two Input NAND Gate 10005040000 


"7402' TTL Quad Two Input NAND Gate 10001040002 
'74LS02' TTL Quad Two Input NAND Gate 10002040002 
ASO 2s TTL Quad Two Input NAND Gate 10003040002 


'74ALSO2' TTL Quad Two Input NAND Gate 10004040002 
'74AS02' TTL Quad Two Input NAND Gate 10005040002 
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Motor Drive Circuitry 
786-256A-001 


Revised: June 22, 1986 


iL 


Bill Of Materials September 15, 1986 14:48:48 Page 1 
Item Quantity Reference Part 
a 1 Ul 8051 
2 af X1 12 mHz 
3 2 CHic2 30 pf 
4 al C3 20 uF 
5 al U3 2132 
6 1 u4 8282 
7 2 R2,R4 6.8K 
8 a R3 470 
9 al US 74LS73 
10 de U6 74LS86 
Te: v FUSE1] 2 AMP 
2 1 anal $c140 
ahs 1 R8 47 
14 2 D2; Ds 1N4004 
L5 2 Q27:03 PIP EY O 
16 au R9 5 ohm 
19, 1 Swl SpSt 


6.11.7 Sample PARTLIST Output Using an 
Include File 


NOTE 


The PARTLIST utility does not check for 
duplicate entries in the include file. If one 
exists, the program may become suspended. 


The include file is also case and trailing- 
character sensitive. For example: if a part is 
labeled: 2.5 mH in your worksheet, 
PARTLIST does not make a match if your 
Include File has the part as: 2.5 MH. 
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Motor Drive Circuitry Revised: June 22, 1986 
786-256A-001 Revision: 1 
Bill Of Materials September 15, 1986 14:48:48 Page 1 


Item Quantity Reference Part DESCRIPTION Part Order Code 


1 iL Ul 8051 Intel Controller 10002048505 
2 1 X1 12 mHz Crystal 10000820006 
3 2 Ci, C2930) pr Capacrtorm Mica 10000483736 
4 if (ex) 20 uF Capacitor Tantalum 10000486353 
5 1 U3 PAUSE 32K EPROM 10002734645 
6 1 U4 8282 Latch 10008475663 
z7 2 R2,R4 6.8K Resistor 1/4 Watt 5% 10038437622 
8 1 R3 470 Resistor 1/4 Watt 5% 10038437862 
9 il U5 74LS73 J-K Flip Flop 10008756353 
10 1 U6 74LS86 2 input EX-OR Gate 10008756349 
iFal ah FUSE1 2 AMP Slow Blow Fuse 15000063731 
12 1 gual $C140 2 AMP Triac 10040000295 
13 il R8 47 Resistor 1/4 Watt 5% 10038437023 
14 2 D2,D3 1N4004 Diode 10092735660 
i's} 2 Q2,Q3 TIP110 Power NPN 12000838388 
16 al R9 5 ohm Resistor 1/4 Watt 5% 10038430005 
17 ik swl SpSt B&K 100 MA Switch 10842100954 
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6.12 PLOTALL 
Purpose: 


Plots a group of schematic sheets which may be a 
hierarchy, flat file, one sheet file structure, or an 
annotation file. As an option, grid references may 
be specified. 


- Format: PLOTALL source [destination] 
VAI/CI/DIVEN/FI/GIV/OIWPI/QI/S) 


Remarks: 


The source may be either the root sheet name of a 
hierarchical file structure, the name of a text file 
in a flat file structure, or the file name of a one 
sheet file structure. 


If the source is the name of a text file in a flat file 
structure, the /F switch must be included. Ifthe 
source is the file name of a one sheet file structure, 
the /O switch must be included. Ifthe source is 
the annotation file created by the ANNOTATE 
program, then the /A switch must be included on 
the invocation line. 


The destination is any valid DOS path name and 
is where the output of the program is to be placed. 
If a destination is not specified, the output of the 
PLOTALL program is directed to the serial 
channel specified in the plotter configuration 
(refer to Section 2 for configuration information). 


The /A switch causes the PLOTALL program to read 
the source path as an annotation file. 
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The /C switch causes the configuration menu to be 
invoked. This allows the OrCAD/SDT III environment 
to be modified. 


The /D switch causes PLOTALL to descend into parts 
defined as sheetpath parts. That is, you can think of the 
utility as treating a sheetpath part as sheet during its 
operation. 


The /E switch causes the utility program to display the 
message "Type Any Key To Continue", enabling the 
system to pause for you to remove the 
DRIVER/LIBRARY disk in drive B and insert the 
SHEET disk. This switch is used only on systems with 
two floppy disk drives. 


The /F switch causes the PLOTALL program to read 
the source as a text file, for flat file structure 
applications. 


The /G switch causes GRID REFERENCES to be 
included in the sheet when plotting. 


The /O switch causes the file name of the source to be 
read as a one sheet file structure. 


The /P switch plots the worksheet to a configured 
printer instead of plotter (Make sure you have 


adequate disk space. This utility creates temporary 
files). 


The /Q switch causes the PLOTALL program to run 
“quietly”. This means that only the invocation messages 
and error messages if any, are displayed. If this switch 
is not specified, the program will display intermediate 
tracking activity. 


The /S switch scales the plot by a user specified scale 
factor entered at invocation time. The scale factor is a 
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decimal number in the form: #.###, not all trailing 
digits are needed. 


NOTE 
No check is made if the plot will fit on the 


plotter, nor are multiple sheets plotted if 
they are too big. 


6.12.1 Invocation Examples Using Hierarchical 
Structured Files 


1. To plot sheets in a hierarchical schematic: 
PLOTALL root.sch 


Where root.sch is the path and name of the root 
sheet in the hierarchy. 


2. To plot a sub-sheet in a hierarchical schematic: 
PLOTALL subsheet.sch /O 
Where subsheet.sch is the path and name of the 


sub-sheet in the hierarchy, /O signifies that the 
subsheet.sch file name is a single sheet. 


6.12.2 Invocation Examples Using Flat File 
Structures 


1. Toplota flat file structure containing multiple 
sheets: 


PLOTALL flatfile.txt /F 


Where flatfile.txt is a text file containing a list of 
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schematic file names to be plotted, /F is used to 
signify that flatfile.txt is a text file. 


2. Toplot one sheet in a flat file structure: 
PLOTALL sheetname.sch /O 


Where sheetname.sch is the name of the single 
sheet in the flat file structure, /O is used to signify 
that sheetname.sch is a single sheet schematic. 


6.12.3 Invocation Examples Using A One Sheet 
File Structure 


To plot a single sheet schematic: 
PLOTALL sheetname.sch /O 


Where sheetname.sch is the name of the single 
sheet schematic, /O is used to signify that 
sheetname.sch is a single sheet schematic. 


6.12.4 Invocation Example - Directing The Output 
To A File 


To direct the output of the PLOTALL program to 
a file: 


PLOTALL sheetname.sch whatfile /O 


Where sheetname.sch is the name of the single 
sheet schematic, whatfile is the path and file 
name to place the PLOTALL information, and /O 
is used to signify that sheetname.sch is a single 
sheet schematic. 
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NOTE 


The file whatfile may be sent to a plotter. 
using the DOS MODE and COPY 
commands. For example, if your plotter is 
connected to serial channel 1, enter the 
following at the DOS prompt: 


COPY whatfile COM1: 
- For additional information on the MODE 


and COPY commands, refer to your DOS 
Users Manual. 


6.12.5 Plotting Schematics Based on Annotation 
Files 


To plot schematics based on the annotation file 
information: 


PLOTALL annotation.out /A 


Where annotation.out is the output from the 

ANNOTATE program, /A causes the PLOTALL 

program to read annotation.out as an annotation 
file. 


6.12.6 Setting Up The Plotter Configuration 
To setup the plotter configuration, go to the DRAFT 
configuration menu by entering the following from the 
DOS command line: 

PLOTALL /C 
Press the <P> and <L> keys to configure the plotter 


drivers, serial channel, baud rates, parity and word 
length. 
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To configure OrCAD/SDT III for the plotter driver, 
select the letter that corresponds to the plotter driver 
that you are using at the "Enter Letter to Select the 
Plotter to be used->" prompt. If your plotter name does 
not appear, press <S> for Special. When selected, the 
plotter driver name only appears on the 
“CONFIGURATION OF OrCAD/SDT III" menu. 


To modify the serial channel, baud rate, parity, or word 
length configuration, press the colon <:> key at the 
"Enter Letter to Select the Plotter to be used->" prompt. 
Enter a "1" for serial channel 1, or a "2" for serial 
channel 2 at the "Channel 1 or 2 ->" prompt. 


After you select the serial channel, you may select the 
baud rate, parity, and word length that is required. 


To modify the baud rate, enter the letter that 
corresponds to the baud rate you require at the "Baud 
Rate ->" prompt. 


To modify the parity, enter the number that 
corresponds to the parity you require at the "Parity ->" 
prompt. 


To modify the word length, enter the number that 
corresponds to the word length you require at the 
“Word Length ->" prompt. 


When you return to the "CONFIGURATION OF 
OrCAD/SDT III" menu, be sure to update the 
information by pressing the letter <U>. 


A typical configuration for HP, HI, and IOline plotters 
is: 


Baud Rate: 2400 or 9600 
Parity: No Parity 
Word Length: 8 bits 


Use the driver HI.DRV for IOline plotters. 
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6.12.7 Plotter Cable Wiring Diagrams 


The PLOTALL utility program uses BIOS to 
communicate to the serial port. It does not talk to the 
hardware directly. This is to insure compatibility to all 
PC's and compatibles. 


For this reason, additional wires other than TXD and 
RXD must be connected to implement hardware 
handshake. 


Figure 6-21 shows a wiring diagram that is required 
for connecting a PC/XT (25 pin connector) to a plotter. 
Figure 6-22 shows a wiring diagram that is required 
for connecting a PC AT (9 pin connector) to a plotter. 


Since this cable connects the TXD and RXD lines, it 
also works with software that communicates to the 
hardware directly. 


COMPUTER PLOTTER 


Figure 6-21. PC/XT 25-Pin Cable Wiring Diagram 
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COMPUTER oy a 
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Figure 6-22, PC AT 9-Pin Cable Wiring Diagram 


COMPUTER PLOTTER 
ee kt eee ttl 
i Res ee 
( tcaeaileald 
Sea ses 
bbe A ieee 
5 eee sad 


Figure 6-23. PC/XT 25-Pin Cable to IOline Plotter 


6.12.8 Plotter Problems 


Most plotter problems are typically a result of 
incorrectly wired plotter cables. If you have difficulty 
with your plotter, check the following items before 
proceeding or calling OrCAD: 


ily Wire the cable as shown in Figures 6-21, 6-22, 
and 6-23 above. If your plotter works with 
another software package, and does not work 
with OrCAD, the first item to check is the wiring 
of your cable. Chances are, the other CAD 
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packages only require the TXD and RXD signal 
lines. OrCAD requires additional connections. 


The cable must be wired rovrectly as 
recommended! 


2. Check for an open in the cable by performing a 
continuity check. 


3. Read your plotter manual to be sure you 
- understand how the plotter operates. Know how 
it is programmed for baud rate,parity, word 
length, and find out what these settings are. 


4, Check to make sure that the plotter baud rate, 
parity, and word length settings correspond to the 
plotter configuration information. 


For HI plotters, if data and parity do not match, 
the message: "<<<error>>> Unable to read back 
from plotter"appears on the screen. 


5. | Use DOS to send a plot file to the plotter. This will 
be useful for isolating whether the problem is in 
the serial port hardware or the plotter hardware. 
To do this, first send the worksheet to a plot file as 
outlined below: 


PLOTALL sheetname.sch whatfile /O 


Where sheetname.sch is the name of the single 
sheet schematic, whatfile is the path and file 
name to place the PLOTALL information, and /O 
is used to signify that sheetname.sch is a single 
sheet schematic. 


Then, use the DOS MODE command to configure 
the serial channel as follows: 


MODE COM1:2400,N,8,1,P <ENTER> 
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This assumes that you are using serial channel 1 
(COM1) and have your plotter set for 2400 baud, 
no parity, 8 data bits, and 1 stop bit. For more 
information on the MODE command, refer to 
your DOS users guide for Asynchronous 
Communications. 


After the serial channel has been configured, send 
the plot file to the plotter using the DOS COPY 
command as follows: 


COPY whatfile COM1: <ENTER> 


Where whatfile is the name of the plot file. 


If the plotter works, this indicates the problem 
may be in the plotter cable (incorrectly wired), or 
the hardware handshaking is incorrectly set 
(check PLOTALL configuration). 


If the plotter does not work, this indicates that 
there is a hardware problem. Check the the 
following: serial card, incorrect serial channel 
configuration, plotter hardware, or a cable 
problem. 


6. I£fyours is an [Oline plotter, be sure you have 
PROM version 114 or greater. 


6.12.9 Output Scaling 


OrCAD controls the output scaling using the /S switch, 
at invocation time.The /S switch scales the plot by a user 
specified scale factor entered at invocation time. The 
scale factor is a decimal number in the form: #.###, 
not all trailing digits are needed. No check is made if 
the plot will fit on the plotter, nor are multiple sheets 
plotted if they are too big. 
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Output scaling is also controlled by your plotter. Plotter 
scaling is typically controlled by the size of the paper 
used, Pl and P2 point settings (HP plotters), rotation 
settings, and the default settings on the plotter. 


If you change the size of the worksheets you are 
plotting, (plotting a C size, then a B size worksheet for 
example) always RESET the plotter when changing 
worksheet size. If you have further scaling questions, 
refer to your specific plotter manual. 


6.12.10 Plotter Hints 


When making a plot, use the proper pens and paper 
designed for the plotter. Plotter paper has a "memory" 
to it. Ifit hangs on the plotter bed for a period of time, it 
will stretch. This effects the registration of the plot. 
Plotter paper is also temperature sensitive. Be sure 
that the paper is at room temperature before plotting. 
The longer the drawing takes to plot, the more care 
must be exercised with the paper. 


The configuration of the plotter includes the ability to 
change the velocity of the pens. When the pen can not 
draw at the speed the plotter is capable of moving, 
reduce the velocity. You will need to consult your 
plotter manual for the range to set the velocity. The 
velocity can be set only in whole number values. 


When you make a plot with different pens, the plotter 
has a registration inaccuracy that must be considered. 
If you wish to have the highest quality plot, always use 
only one pen. 


When you make a plot on a paper size that does not 
match the worksheet size, the plotter drivers will scale 
the drawing to fit the paper selected. We do not 
recommend making a plot more than one size off of the 
worksheet size since the width of the pen is fixed. For 
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example, you can plot a C size worksheet on B, C, or D 
and it will work fine. If you plot an E worksheet on A 
paper, you will not be able to read the writing. If you 
plot an A worksheet on E size paper, the bit mapped 
devices will be "grainy". 


When you are directed by the program to change paper 
or pens, always wait until the plotter has finished the 
present plotting activity. Before sending a plot directly 
to the plotter, be sure that the plotter is on line, the 
pen(s) are properly set up, and the paper size is correct. 
When you have a pen that must be manually changed, 
the PLOTALL program will pause and inform you of 
the objects to be plotted with the new pen. 


6.12.11 HP Plotters 


The HP plotter family has a facility to set the corner 
points of the plot and automatically scale the plot to be 
within these points. These points are called Pl and P2. 


NOTE 


PLOTALL draws in .00I" resolution and 
ignores the preset Pl and P2 values 


PLOTALL assumes the origin of the plot is the lower 
left corner of the page (when the finished plot is 
viewed). Rotation and paper size must be set before you 
run a plot. 


If the plotter's origin (0,0) is not the lower left corner, it 
may be moved via the template table in the 
configuration menu. To move the origin, configure the 
plot X-offset and Y-offset (integer value -32.768" to 
+32.767") in the template table. Note that this origin 
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offset can be used on any plotter to adjust where the plot 
is made on the page. 


For large HP plotters (HP 7580, 7585, 7586, etc.), the 
origin is the center of the page and the template offset 
values must be set. 


6.12.12 HI Plotters 


The HI plotter family does not automatically scale the 
drawing. If you direct the output of the PLOTALL 
program to a file you will be prompted, for each plot, for 
the paper size to use for the plot. The aspect ratio is 
corrected for both direct-to- plotter and re-directed-to- 
file plots. 


The HI 40 Series defaults to 2400 baud, and the 50 
Series defaults to 9600. Always check to make sure 
that the plotter baud rate, and data bit settings 
correspond to the plotter configuration (refer to "Setting 
Up The Plotter Configuration" above). 


If data and parity do not match, the message: 
"<<<error>>> Unable to read back from plotter" 
appears on the screen. 


Be sure that the plotter is on-line before beginning a 
plot. The HI plotters do not have a means to set the 
velocity to the power-up default. If you change any of 
the velocity settings of the pens in the configuration, 
you will need to set them all. The velocity ranges can be 
found in the plotter operation manual for your specific 
plotter. 


6.12.13 Suppressing the Title Block and Border 


To suppress the title block and border of the worksheet, 
invoke the Configuration Menu by entering "DRAFT 
/C" from the DOS command line. 
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Press <C> <T> to obtain the "Color Table / Plotter Pen 
Table". At the "Command ->" prompt, press the <P> 
<M> keys. Then, press <9> <9> followed by the 
<ENTER> key. The plotter pen is now IGNORED for 
drawing the worksheet title block and border. 
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6.13 PRINTALL 
Purpose: 


Prints a group of schematic sheets which may be 
a hierarchy, flat file, one sheet file structure, or an 
annotation file. As options, grid references, scaled 
output, and wide paper can be specified. 


Format: 


PRINTALL source [destination] 
VAIJ/CI/DIVEN/FI/GI/O}/QIi/w] 


Remarks: 


Source may be either the root sheet name of a 
hierarchical file structure, the name of a text file 
in a flat file structure, or the file name of a one 
sheet file structure. 


If the source is the name of a text file in a flat file 
structure, the /F switch must be included. Ifthe 
source is the file name of a one sheet file structure 
the /O switch must be included. If the source is 
the annotation file created by the ANNOTATE 
program, then the /A switch must be included on 
the invocation line. 


’ 


The destination is any valid DOS path name and 
is where the output of the program is to be placed. 
If a destination is not specified, the output of the 
PRINTALL program is directed to the printer 
PRN. 


Output resolution depends on which printer 
driver you have configured. For example, there 
are four HP LaserJet printer drivers available 
with OrCAD/SDT III (75, 100, 150, and 300 dpi). 
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If you have the 150 dpi driver configured, then 
the output resolution is 150 dots per inch. 


The /A switch causes the PRINTALL program to read 
the source path as an annotation file. 


The /C switch causes the configuration menu to be 
invoked. This allows the OrCAD/SDT III environment 
to be modified. 


The /D switch causes PRINTALL to descend into parts 
defined as sheetpath parts. That is, you can think of the 
utility as treating a sheetpath part as sheet during its 
operation. 


The /E switch causes the utility program to display the 
message "Type Any Key To Continue", enabling the 
system to pause for you to remove the 
DRIVER/LIBRARY disk in drive B and insert the 
SHEET disk. This switch is used only on systems with 
two floppy disk drives. 


The /F switch causes the PRINTALL program to read 
the source as a text file, for flat file structure 
applications. 


The /G switch causes GRID REFERENCES to be 
included in the sheet printout. 


The /O switch causes the file name of the source to be 
read as a one sheet file structure. 


The /Q switch causes the PRINTALL program to run 
"quietly". This means that only the invocation messages 
and error messages if any, are displayed. If this switch 
is not specified, the program will display intermediate 
tracking activity. 


The /W switch causes the printing to formatted for 


wide paper. With this switch, the printing will be setup 
for 13" wide paper based on the parameters of the 
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printer driver. If the /W switch is not present, then the 
printing will be formatted for 8" paper. 


6.13.1 Invocation Examples Using Hierarchical 
Structured Files 
1. To print sheets in a hierarchical schematic: 


PRINTALL root.sch /S 


Where root.sch is the path and name of the root 
sheet in the hierarchy. 


2. To print a sub-sheet in a hierarchical schematic: 
PRINTALL subsheet.sch /O /S 
Where subsheet.sch is the path and name of the 


sub-sheet in the hierarchy, /O signifies that the 
subsheet.sch file name is a single sheet. 


6.13.2 Invocation Examples Using Flat File 
Structures 


1.  Toprint a flat file structure containing multiple 
sheets: 


PRINTALL flatfile.txt /F 
Where flatfile.txt is a text file containing a list of 
schematic file names to be printed, /F is used to 
signify that flatfile.txt is a text file. 

2. To print one sheet in a flat file structure: 


PRINTALL sheetname.sch /O 


Where sheetname.sch is the name of the single 


6-109 


PRINTALL Schematic Design Tools 


sheet in the flat file structure, /O is used to signify 
that sheetname.sch is a single sheet schematic. 


6.13.3 Invocation Examples Using A One Sheet 
File Structure 


1. Toprint a single sheet schematic: 
PRINTALL sheetname.sch /O /S 


Where sheetname.sch is the name of the single 
sheet schematic, /O is used to signify that 
sheetname.sch is a single sheet schematic. . 


2. To direct the output of the PRINTALL program 
to a file: 


PRINTALL sheetname.sch whatfile /O 

Where sheetname.sch is the name of the single 
sheet schematic, whatfile is the path and file 
name to place the PRINTALL information, and 


/O is used to signify that sheetname.sch is a single 
sheet schematic. 


NOTE 


Since whatfile is a binary print file, it will 
consume an extensive amount of disk space. 


The file whatfile may be sent to a printer using 
the DOS COPY Command. For example, enter 
the following at the DOS prompt: 


COPY whatfile prn: /b 
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For additional information on the COPY 
Command, refer to your DOS Users Manual. 


6.13.4 Printing Schematics Based on Annotation 
Files 


PRINTALL annotation.out /A/S 


Where annotation.out is the output from the 
ANNOTATE program, /A causes the PRINTALL 
program to read annotation.out as an annotation 
file. 
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6.14 TREELIST 
Purpose: 


Scans a hierarchical file structure of schematics 
to display the sheet names, sheet path names, and 
optionally the date of last modification. This 
utility is useful for organizing and keeping track 
of the hierarchical worksheets. 


Format: 


TREELIST source [destination] 
V/AI/CI/DIVEN/FI/Q) 


Remarks: 


The source is the name of the root sheet of a 
hierarchical organization of schematics. Only a 
sheet name will be accepted. 


The destination is any valid DOS path name and 
is where the output of the program is to be placed. 
If a path is not specified, the output will be directed 
to the console. 


Libraries are not required to be loaded for 
operation of this utility program. Therefore, the 
/E switch is not required. 


The /A switch causes the program to read the source 
path as an annotation file. This will cause the 
annotation file to be updated. 


The /C switch causes the configuration menu to be 
invoked. This allows the OrCAD/SDT III environment 
to be modified. 


The /D switch causes the program to include the date of 
last modification in the output for each sheet scanned in 
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the hierarchy. Ifa sheet symbol is encountered but the 
physical sheet has not been created, then the program 
will display, in place of the date, <empty worksheet>. 


The /E switch causes the utility program to display the 
message "Type Any Key To Continue", enabling the 
system to pause for you to remove the 
DRIVER/LIBRARY disk in drive B and insert the 
SHEET disk. This switch is used only on systems with 
two floppy disk drives. 


The /F switch causes the TREELIST program to read 
the source as a text file, for flat file structure 
applications. 


The /Q switch causes the TREELIST program to run 
"quietly". This means that only the invocation messages 
and error messages if any, are displayed. If this switch 
is not specified, the program will display intermediate 
tracking activity. 


6.14.1 Invocation Examples Using Hierarchical 
Structured Files 
Le To create a hierarchical schematic tree list: 


TREELIST root.sch 


Where root.sch is the path and name of the root 
sheet in the hierarchy. 


2. To direct the output of the TREELIST program to 
a file: 


PRINTALL root.sch whatfile 


Where root.sch is the path and name of the root 
sheet in the hierarchy, and whatfile is the path 
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and file name to place the TREELIST 
information. 


6.14.2 Sample Output from the TREELIST Utility 


Scanning "SHEET\286sys.sch" 
Scanning "SHEBT\286proc.sch" 
Scanning "SHEET\286i0.sch" 
Scanning "SHEET\286hd.sch" 
Scanning "SHEET\286£fd.sch"™ 
Scanning "SHEET\286lan.sch" 
Scanning "SHEET\286gd.sch" 
Scanning "SHEET\286mem.sch" 
<<<Root File>>> 
[2e66sys.scn! Februaty,23, 19686 
Processor and Control 
[286proc.sch] August 28, 
1986 
Peripheral Interface 
[286i0.sch] January. 20, 1986 
Hard Disk Interface 
(286hd.sch] October 47,, 1986 
Floppy Disk Interface 
{286fd.sch] December 6, 1986 
LAN Interface 
[286lan.sch] <empty 
worksheet> 
Graphics Display Subsystem 
[286gd.sch] May 31, 1986 
Memory Array 
[286mem.sch] June 16, 1986 
DISCUSSION 


The first eight lines illustrate the TREELIST program 
scanning each sheet in the hierarchy retrieving 
pertinent information. 


Text enclosed within brackets [] represents the file 
name of the hierarchical sheets, [286sys.sch] for 
example. The date represents the date of the last sheet 
modification. 


Text placed below the worksheet file name and date, on 


the same indentation level, represent the names of 
sheet symbols that are placed in worksheet. “Processor 
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and Control" and "Peripheral Interface" for example, 
are sheet symbols placed in the [286sys.sch] worksheet. 
[286proc.sch] is the file name that represents the 
"Processor and Control" sheet symbol and [286io.sch] is 


the file name that represents the "Peripheral Interface" 
sheet symbol. 
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SN 7. LIBRARIES 


This section how to create your own "custom" part 
libraries for use with OrCAD/SDT III. OrCAD/SDT III 
provides two methods for creating a custom library. 


1. You can invoke the library editor called 
LIBEDIT.EXE. With this editor, you can use 
commands similar to those of ORCAD/SDT to 
construct a part and add it to a new or existing 
library. 


2. You can use a text editor to create a library source 
file. A library source file is an ASCII text file that 
contains instructions in the OrCAD Symbol 
Description Language. You then run the 
composer utility called COMPOSER.EXE on that 
library source file to produce a library data file 
readable by ORCAD/SDT. 


Figure 7-1 illustrates the development process using 
COMPOSER for creating a custom part library. 
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Figure 7-1. The Library Development Process Using 
COMPOSER 


7.1 OVERVIEW OF ORCAD LIBRARIES 


OrCAD supplies a number of part libraries for use with 
ORCAD/SDT. OrCAD-supplied libraries are shipped as 
library data files. This is for your convenience (data 
files are ready to use) as well as to save disk space. A 
library source file takes up much more disk space than 
its corresponding library data file. A source file can be 
four or five times as large as its data file. 


Part of configuring ORCAD/SDT means choosing what 
libraries it will have access to. The libraries you choose 
at configuration time are loaded into RAM when you 
invoke ORCAD/SDT. This eliminates disk searching 
and provides for quick part retrieval. 
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You may have parts with the same name in different 
libraries. If you do and those libraries are selected, 
ORCAD/SDT searches through the libraries in the 
order you specify at configuration time. 


You can choose from OrCAD-supplied libraries as well 
as your own custom libraries. The custom libraries that 
you create will behave just like the OrCAD-supplied 
libraries. 


By convention, library names end with the file 
extension .LIB. For example, the name of th OrCAD- 
supplied library of Motorola parts is MOTO.LIB. Also, 
by convention, library source files-have the file 
extension .SRC. Note, however, that the .LIB and .SRC 
extensions are conventions, not requirements. 


Creating custom libraries is preferable to modifying 
OrCAD-supplied libraries. If you modify an existing 
library, you run the risk of future OrCAD updates 
negating your changes. It is not good practice to edit an 
OrCAD-supplied library. 


7.2 THE COMPONENTS OF A LIBRARY PART 


Whether you use the library editor LIBEDIT or a text 
editor along with the composer and decomposer, you 
are building library parts from the same basic 
components. 


A part consists of the following parts: one or more 
names, a sheetpath designator, a reference designator, 
pins, and a body. You can also place text within a part 
as a comment. 
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Names 


Sheetpath designator 
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A part has one or more names. 
Parts have identical symbols 
are represented in a library as 
one part with multiple names. 
For example, 2114, 2146, 
2149, etc. all identify the same 
symbol and represent alK X 
4 static RAM. 


A sheetpath designator is a 
pathname that references a 
schematic file. By using a 
Sheetpath designator, you can 
construct a part symbol and 
define it as previously 
constructed schematic. 
Sheetpath designators provide 
a higher level of abstraction 
for the circuit under 
construction and are useful 
for frequently used circuits. 
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Reference designator The reference designator 
indicates the instance of a part 
on the schematic. A device 
may have one part per 
package or multiple parts per 
package. 


The prefix of the reference 
designator represents the 
class of the part. For example, 
U is normally used for ICs, Q 
is for transistors, C is for 
capacitors, and R is for 
resistors. 


The reference designator has 
a number indicating the 
occurrence of the device itself 
and a letter indicating the 
particular part in a multiple- 
part-per-package device. 


For example, U2C indicates 
the second occurrence of an 
IC package and the third 
occurrence of the part. 
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Pins Each pin has a type, shape, a 
number, and possibly a name. 


Type. Typical pin types are 
input, output, bidirectional, 
etc. A pin can have only one 
type. Except for power, the 
pin type is not apparent from 
the representation of the part 
on the screen. Power pins are 
invisible. 


Shape. The pin shape 
determines how the pin 
appears on the screen. A pin 
can have either a normal ora 
short lead. A normal lead can 
also have a clock symbol or an 
inversion bubble; a short lead 
cannot. 


Number. The package 
number of a pin appears 
outside the part beside the 
lead. 


Name. The pin name is 
associated with the pin 
function. For example, AO 
represents an address line, 
and CLR represents the clear 
function. 


Body The body is either a block or a 
graphic. A block is a rectangle 
like amemory chip. A 
graphic has curved edge like 
an AND gate. 
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7.3 USING THE LIBRARY EDITOR, LIBEDIT 


With the library editor LIBEDIT you can create a new 
library, edit the part definitions of an existing library, or 
add part definitions to an existing library. 


Typical uses of the library editor are as follows. 1) You 
want to create a new part and add it to an existing ora 
new library. 2) You want to part that is similar, but not 
identical, to a part in an OrCAD-supplied library. You 
invoke the library editor, retrieve the similar part, edit 
it, and then write it out to an existing or new library. 3) 
You want to modify an existing part in an existing 
library. 


CAUTION 


It is good practice to preserve the integrity of 
OrCAD-supplied libraries. If you want to 
modify parts in an OrCAD-supplied library, 
extract those parts, edit their definitions, and 
then write them out to a custom library. 


Refer to Section 7.3.23, Example of Using LIBEDIT, for 
an example of how to create a custom library. The | 
example shows how to extract a part from the OrCAD- 
supplied library TTL.LIB, modify it, and write it out toa 
new library. 


7.3.1 Configuring LIBEDIT.EXE 


When you configure LIBEDIT, DRAFT or another of 
the OrCAD/SDT III utilities, you are setting values in 
ORCADSDT.OVL. Ifthe three files (LIBEDIT.EXE, 
DRAFT.EXE, and ORCADSDT.OVL) are in the same 
directory, then configuring one also configures the 
others. LIBEDIT requires the overlay file that it uses to 
be in the same directory as LIBEDIT.EXE. 


7-7 


Libraries Schematic Design Tools 


Because LIBEDIT, DRAFT and the other ORCAD/SDT 
utilities use the same overlay file (ORCADSDT.OVL), 
most users place LIBEDIT.EXE in the same directory 
as DRAFT.EXE, ORCADSDT.OVL, and the other 
utilities. 


However, if you put LIBEDIT in a different directory, 
you must also place another copy of ORCADSDT.OVL 
in that directory; and you must then configure 
LIBEDIT separately. For example, configuring 
DRAFT changes the copy of ORCADSDT.OVL used by 
DRAFT, and configuring LIBEDIT changes the copy of 
ORCADSDT.OVL used by LIBEDIT. 


To configure an OrCAD/SDT ITI utility, invoke it with 
the /c switch. For example, to configure LIBEDIT, type 
the following command: 


LIBEDIT /c 


The configuration menu then appears. This is the 
same configuration menu that appears when you 
configure DRAFT, even though some of the fields have 
no meaning for LIBEDIT. Refer to Section 2.? for 
detailed information about the configuration menu. 


7.3.2 Invoking LIBEDIT 


To invoke LIBEDIT, first make its directory the 
current directory by issuing the DOS cd command. 
Note that this section assumes that LIBEDIT.EXE is 
contained in the directory, C:\ORCAD. Then, type 
LIBEDIT. You can optionally follow LIBEDIT with the 
name of a library data file that you want to edit. 


CD \orcad 
LIBEDIT filename.LIB 


If you leave out the name of a library data file, 
LIBEDIT prompts you for one. The operation is similar 
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to that of invoking ORCAD/SDT on a schematic file. By 
convention, a library data file has the extension .LIB, 
but it is not required. 


7.3.3 Limits on a Part's Complexity 


When using LIBEDIT, you construct a part from lines, 
arcs, circles, etc. Each part has a maximum allowed 
number of such elements. The limit is for each part 
body; that is, the limit for a normal part is distinct from 
the limit for its CONVERT. Also, the limit does not 
depend on the number of parts per package. 


For example, consider a part that has four parts per 
package and a CONVERT. There are two limits that 
are pertinent for this part, one for the normal version 
and one for the CONVERT version. If you edit the part 
so that it has only two parts per package, the limits do 


not change. magi Cosotiyyt | aem 

The limits are as follows: i 

Lines he 

Circles 127. The IEEE symbol 
negation counts as a circle. 

Text 255 strings. Each string has a 
maximum of 10 characters. 

Arcs . 63 

Fills 31 


7.3.4 Vectors vs. Bitmaps 


LIBEDIT knows about and uses vectors, not bitmaps. 
However, many parts in existing libraries are 
constructed with bitmaps and not vectors. 
Consequently, when you run LIBEDIT and call up a 
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part from that library, you don't see the part's shape. 
The bitmap defining the shape is still there. It's just that 
LIBEDIT is not designed to deal with bitmaps. 


If you call up a bitmap part and write it back to the 
library with the LIBRARY Update Current followed by 
QUIT Update or QUIT Write, you save the part as it 
appears on the screen -- that is, without a body. You 
have lost the bitmap. Before writing to the library, 
ensure that the part has a body as it appears on the 
screen. 


If you use LIBEDIT to design a part with vectors and 
then write it out to the library, the part is stored both as 
a vector part and a bitmap part. The vector part is used 
for plotting, and the bitmap part is used for screen 
work. The reason for this is that bitmap parts are 
easier to manipulate on the screen and hence improve 
screen performance whereas vector parts result in 
higher quality plots. For example, vector-based parts 
don't show jagged curves. 


7.3.5 LIBEDIT Commands 


Many of the LIBEDIT commands are familiar to you 
from ORCAD/SDT. The main command menu 
consists of the following commands: 


Again Origin 
Body Pin 
Conditions Quit 

Get Part Reference 
Jump Set 
Library Tag 
Macro Zoom 
Name 
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7.3.6 AGAIN 


AGAIN repeats the previously executed main-level 
command. Note, however, that AGAIN executes only 
the previous main-level command. For example, if you 
execute a command in the BODY menu and then select 
AGAIN, the BODY menu appears, ready for you to 
select another BODY command. AGAIN does not 
repeat the last series of commands beginning at the 
BODY menu. 


T.30 BODY 


BODY displays the menu used for drawing a part. You 
can choose between two types of parts: graphic and 
block. 


¢ Agraphic part is one who body contains curves or 
arcs. For example, an OR gate is a graphic part. 


¢ Ablock part is one whose body is a square or 
rectangle. For example, a JK flip-flop is a block 


BODY Menu for a BODY Menu fora 
1 Block Part 


Size of Body 
Kind of Body 


IEEE Symbol 
Fill 
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7.3.7.1 BODY Line 


Use the Line command to draw lines. This command is 
similar to the PLACE Wire command in ORCAD/SDT. 
When you select Line, the following menu appears 


Begin 
Jump 
Origin 
Tag 
Zoom 
escape 


To draw a line, select Begin. LIBEDIT returns the 
following menu line: 


Begin End New Jump Tag Zoom escape 


To draw a line, select Begin and move the cursor. To 
complete the line, select Begin, End or New. 


Begin Ends the current line and 
begins a new line where the 
previous line ended. 


End Returns you to the main 
command menu. 


New Ends the current line. You 
can begin a new line ata 
different location with Begin. 


The other items in the Line menu (Jump, Origin, Tag, 
and Zoom) appear in many LIBEDIT menus. They 
operate the same as their corresponding members in 
the main command menu. escape returns you to the 
BODY menu. 
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7.3.7.2 BODY Circle 


Use the Circle command to place a circle within the 
part outline. 


When you select Circle, the Circle menu appears. It 
contains the following items: 


Center 
Jump 
Origin 
Tag 
Zoom 
escape 


To place a circle, move the cursor to where you want 
the center of the circle. Then, select Circle. The 
following Edge menu appears: 


Edge 
Jump 
Origin 
Tag 
Zoom 
escape 


Now when you move the cursor, you see the circle 
expand. Move the cursor to where you want the edge 
of the circle and then select Edge. You have now placed 
a circle. The Circle menu returns. 


The other items in the Edge and Circle menus (Jump, 
Origin, Tag, and Zoom) appear in many LIBEDIT 
menus. They operate the same as their corresponding 
members in the main command menu. escape in the 
Edge menu returns you to the Circle menu, and escape 
in the Circle menu returns you to the BODY menu. 
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7.30.35 BODW Atc 


Use the Arc command to place an arc within the part 
outline. An arc is a section of a circle. With the Arc 
command, you can draw an arc ranging from 0o to 
900. 


When you select Arc, the Arc menu appears. It’s 
identical to the Circle menu and contains the following 
items: . 


Center 
Jump 
Origin 
Tag 
Zoom 
escape 


To place an arc, move the cursor to where you want the 
center of the circle from which the arc is to be taken. 
Then, select Center. Another menu appears. It is 
identical to the Edge menu that appears under Circle 
and contains the following items: 


Edge 
Jump 
Origin 
Tag 
Zoom 
escape 


Now when you move the cursor, you see the circle 
expand. You also see a radius extending from the 
center of the circle to the cursor. Move the cursor to 
where you want the one end of the arc to be. Select 
Edge. Then, move the cursor to where you want the 
other end of the arc to be. 


Note that you can only move within a quadrant. (A 
circle is divided into four quadrants by horizontal and 
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vertical lines through the center. Each quadrant is 
90°.) 


Then, select Edge again. You have now placed an arc. 
The Arc menu returns. 


The other items in the Edge and Arc menus (Jump, 
Origin, Tag, and Zoom) appear in many LIBEDIT 
menus. They operate the same as their corresponding 
members in the main command menu. escape in the 
Edge menu returns you to the Arc menu, and escape in 
the Arc menu returns you to the BODY menu. 


7.3.7.4 BODY Text 


With the Text command, you can place text within the 
part outline. The text isa comment. It is not intended 
to be a reference designator for the part or a name for a 
pin. 


When you select Text, the following prompt appears: 
Text? 


Type in the text you want and press <Enter>. The text 
appears at the cursor position. The following menu 
then appears: 


Place 
Larger 
Smaller 
Jump 
Origin 
Zoom 
escape 


Select Larger to make the text larger and Smaller to 


make it smaller. Move the cursor to the position where 
you want the text. 
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Ensure that you place the text within the part outline. 
If any portion of the text lies outside the part outline, the 
results are unpredictable. Refer to Section 7.? "SET 
Show Body Outline" for more information abut part 
outlines. 


Select Place to place the text. The Text? prompt then 
reappears, ready for you to enter another text item. If 
you press <Enter> without typing any text, the BODY 
menu returns. 


The other items in the Text menu (Jump, Origin, Tag, 
and Zoom) appear in many LIBEDIT menus. They 
operate the same as their corresponding members in 
the main command menu. escape returns you to the 
BODY menu. 


7.3.7.5 BODY IEEE Symbol 


The IEEE Symbol places IEEE/ANSI special symbols 
within the part outline. For more information about 
these symbols, refer to ANSI/IEEE Std 91-1984. 


When you select IEEE Symbol, a menu listing IEEE 
symbols appears. That menu is shown below. The 
indented items indicate submenus underneath 
particular IEEE symbols. 


Negation 
Active Low 
Left 
Right 
Arrow 
Left 
Right 
BiDirectional 
Dynamic 
Left 
Right 
Non-logic 
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Analog 
3 State 
Amplified 
Left 
Right 
Passive 
Pull Up 
Pull Down 
Open Circuit 
Open 
H-type 
L-type 
Postponed 
Hysteresis 
Generator 


Note that LIBEDIT treats the symbol Negation as a 
circle. That menus that a Negation symbol counts 
against the maximum number of circles allowed in a 
part definition. 


Select the name of the symbol you want to include in 
your part. Another menu, the IEEE Place menu, 
appears. It is identical to the Text menu and contains 
the following items: 


Place 
Larger 
Smaller 
Jump 
Origin 
Zoom 
escape 


Select Larger to make the symbol larger and Smaller to 
make it smaller. Move the cursor to the position where 
you want the symbol. Select Place to place the symbol. 
The IEEE Place menu reappears, ready for you to place 
another copy of the symbol. escape returns you to the 
IEEE Symbol menu, the list of IEEE symbols. 
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The other items in the IEEE Place menu (Jump, 
Origin, and Zoom) appear in many LIBEDIT menus. 
They operate the same as their corresponding 
members in the main command menu. 


7.3.7.6 BODY Fill 


The Fill command shades the enclosed area around the 
current cursor position. For example, one use of the Fill 
command is to darken the symbols for diodes. 


When you select Fill, the following menu appears: 


Fill 
Jump 
Origin 
Tag 
Zoom 
escape 


To darken an enclosed area around the cursor, select 
Fill from this menu. 


Note that if you edit a part further after using Fill, you 
lose your fills. This is actually a LIBEDIT feature. For 
example, if you remove the boundary on a filled area, 
the fill can take over the whole screen. There is no easy 
way to recover from such a fill takeover. Consequently, 
you must reserve the use of the Fill command for the 
end of your editing session. 


The other items in the Fill menu (Jump, Origin, Tag, 
and Zoom) appear in many LIBEDIT menus. They 
operate the same as their corresponding members in 
the main command menu. escape in the Fill menu 
returns you to the BODY menu. 
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7.3.7.7 BODY Delete 


The Delete command deletes the item that the cursor is 
pointing to. When you select Delete, the following 
menu appears: 


Delete 
Jump 
Origin 
Tag 
Zoom 
escape 


To delete an item, place the cursor on the item and 
select Delete. For the item to be deleted, the cursor 
must actually be on a pixel making up the object. Note 
that when the Zoom scale is 1, you may not easily 
distinguish between a cursor position actually on an 
item and a cursor position just close to a graphic item. 


The other items in the Delete menu (Jump, Origin, Tag, 
and Zoom) appear in many LIBEDIT menus. They 
operate the same as their corresponding members in 
the main command menu. escape in the Delete menu 
returns you to the BODY menu. 


7.3.7.8 BODY Erase Body 


The Erase Body command deletes a part's entire 
graphic body. Use this command when you want to 
start over drawing the graphic body. 


When you select Erase Body, LIBEDIT asks you to 
confirm your choice. Select Yes to delete the graphic 
body. Select No to return to the BODY menu. 
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7.3.7.9 BODY Size of Body 


The Size of Body command changes the size of the part 
being edited. When you select Size of Body, the 
following menu appears: 


Place 
Jump 
Origin 
Tag 
Zoom 


To increase or decrease the size of the part, move the 
cursor. When the size of the part is what you want it to 
be, select Place. 


Whenever you decrease the size of a part, you always 
lose some detail in its representation. For example, 
restoring a part to its original size after you've shrunk it 
doesn't return the original version. For that reason, if 
you choose to decrease the size of the part, LIBEDIT 
asks for confirmation. 


The other items in the Size of Body menu (Jump, 
Origin, Tag, and Zoom) appear in many LIBEDIT 
menus. They operate the same as their corresponding 
members in the main command menu. Note, however, 
that moving the cursor also changes the size of the part. 
Jumping to a tag is a quick way of resizing the part. 
escape in the Size of Body menu returns you to the 
BODY menu. 


7.3.7.10 BODY Kind of Part 


When you are building a part, you can chose whether is 
it a Block or a Graphic part. When you select Kind of 
Body, the following menu appears: 


Block 
Graphic 
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7.3.7.10.1 BODY Kind of Body Block 


If you choose Block, LIBEDIT requests the number of 
parts per package. You are given a list of choices from 
0 to 16. Select the appropriate number. 


Then, LIBEDIT asks if the part is a grid array. If you 
choose Yes, then pin names can be any alphanumeric 
text string of 15 characters or less. 


Finally, LIBEDIT asks if the part is a sheet symbol. A 
sheet symbol is a circuit that you previously 

constructed with ORCAD/SDT and stored asa 
schematic file. If you choose Yes, LIBEDIT requests the 
pathname of the schematic file. For example, you could 
use ORCAD/SDT to construct a circuit that you use 
frequently (such as a memory array), assign a part 
symbol to it, and add it to your library. 


7.3.7.10.2 BODY Kind of Body Graphic 


If you choose Graphic, LIBEDIT requests the number 
of parts per package. You are given a list of choices 
from 0 to16. Select the appropriate number. 


Then, LIBEDIT asks you if your part has a CONVERT. 
If you choose No, LIBEDIT does not create nor store a 
CONVERTed form of the part. If you choose Yes, 
LIBEDIT allows you to assign a CONVERT for your 
part. A CONVERT is the version of the part that 
appears when you issue ORCAD/SDT's GET Convert 
command. Typically, users assign the DeMorgan 
equivalent of the part as its CONVERT. 


Finally, LIBEDIT asks if the part is a sheet symbol. If 


you choose Yes, LIBEDIT requests the pathname of the 
schematic file. 
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7.3.8 CONDITIONS 


The CONDITIONS command provides information 
about LIBEDIT. It provides information about the 
following items: Free Library Objects, Free Symbol 
Memory, Free Body Memory, Free Vector Memory, 
Free Macro Buffer, and Free System Memory. 


Free Library Objects This number tells you how 
many names you can add to 
the current library. Note that 
the number represents 
names, not parts. Also, a part 
may have multiple names. 
However, the extra names 
that result from a prefix 
definition do not count. 


Free Symbol Memory This number represents the 
amount of bytes available for 
additional library symbols. 
LIBEDIT symbols include 
part names, pin names, pin 
positions, block symbols, etc. 


Free Body Memory This number represents the 
amount of bytes available for 
additional library bitmaps. 
Note that LIBEDIT does not 
use bitmaps. When you make 
a part with LIBEDIT, you use 
vectors instead. However, 
bitmaps are needed for screen 
work -- for example, DRAFT 
requires a bitmap to display a 
graphic part. Consequently, 
when you add a graphic part 
to a library a bitmap version is 
stored as well as a vector 
version. 
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Free Vector Memory This number represents the 
amount of bytes available for 
additional library vectors. 
LIBEDIT vectors include 
lines, circles, and arcs. 


Free Macro Buffer This number indicates the 
memory available in the 
macro buffer. This buffer 
contains user-created macros 
-- both those created online 
and those loaded from a 
macro file. 


Free System Memory This number indicates how 
much unused memory 
remains in your computer. 


7.3.9 EXPORT PART 


With the Export command, you can write out the 
current part definition (the one being edited) to a file. 
The file is called an export file and is formatted as a 
library source file without a PREFIX-END statement. 
You can only put one part definition per file. 


To add the part in the export file to an existing library, 
invoke LIBEDIT and specify the desired library as the 
current library. Then, use the Import command to 
read in the export file. At this time, you can make 
additional changes to the part using LIBEDIT 
commands. Then, you can add the part to the library 
with the LIBRARY Update Current command. 


Note that a part must be named before it can be written 
to an export file. 
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7.3.10 GET PART 


The GET PART command allows you to retrieve a part 
from a library for editing. When you select GET PART, 
the following prompt appears: 


Get? 


To retrieve a part from the selected library, type the 
name of the part and press <Enter>. The part then 
appears on the screen. 


If you press <Enter> without specifying a part, 
LIBEDIT displays a list of part names. You can then 
select the desired part. 


7.3.11 IMPORT PART 


The Import command reads in a part from another file 
(an export file) created with the Export command. 
Export files can contain only one part definition. 
Import reads in that part definition as the current part. 
It overwrites any existing current part. 


7.3.12 JUMP 


Use the Jump command to quickly move the cursor to 
a different part of your drawing. When you select 
Jump, the following menu appears: 


H tag 
X location 
Y location 
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By selecting a menu item, you can quickly move the 
cursor to a tag from A through H, an X location, or a Y 
location. 


To jump to a tag you must have previously set a tag 
with the Tag command. 


The current XY coordinates are shown in the upper 
righthand corner of the screen. You can move the 
cursor to either a new X or Y location by selecting X 
location or Y location and typing the number. 


7.3.13 LIBRARY 


With the LIBRARY command, you can update the 
current library, browse through the library, and 
import/export library source files. When you select the 
LIBRARY command, the following menu appears: 


Update Current 
List Directory 
Browse 

Delete Part 
Prefix 


7.3.13.1 LIBRARY Update Current 


Updating the library means either changing the 
definition of an existing part or adding a new part. 


To change the definition of an existing part, retrieve the 
part with the GET PART command, edit it, and then 
select Update Current. 


To add a new part, construct the part (you may find it 
easier to retrieve a similar part and edit it), rename the 
part with the NAME command, and select Update 
Current. 
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Note that updating the library with the Update 
Current command modifies the copy of the library 
that's in memory, not the copy on disk. To modify the 
copy of the library on disk, use the QUIT Update File or 
the QUIT Write to File command. 


Creating or editing a part consists of the following steps: 


1. Invoke LIBEDIT and specify a library. LIBEDIT 
reads the library data file into memory. 


2. Retrieve a part. Edit it. The copy of the library in 
memory remains unchanged. 


3. Issue the LIBRARY Update Current command. 
The copy of the library in memory gets the new or 
modified part. You could instead decide to create an 
export file and not modify the library. 


4. Issue the LIBRARY Update File or LIBRARY Write 
to File command. The copy of the library on disk 
gets the new or modified part. Issuing either of 
these commands without previously issuing 
LIBRARY Update Current results in no 
modification to the library, even if you have 
retrieved and modified or constructed a part. 


7.3.13.2 LIBRARY List Directory 


List Directory lists the names of all the parts in the 
library. 


7.3.13.3 LIBRARY Browse 


The Browse command in LIBEDIT operates the same 
as the Browse command in ORCAD/SDT. When you 
select Browse, the following menu appears: 


All parts 
Specific parts 
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NOTE 


When you browse through a library, the 
library parts appear on the screen. When 
you quit browsing, the last part observed 
remains on the screen, ready for editing. 


7.3.13.3.1 LIBRARY Browse All Parts 


Select All parts to view parts starting at the beginning of 
the library and proceeding towards the end. When you 
select All parts, the following menu appears: 


Forward 
Backward 


Quit 


Forward displays the next part. Backward returns the 
previous part. Quit returns you to the main command 
level. The last part observed remains on the screen, 
ready for editing. 


7.3.13.3.2 LIBRARY Browse Specific Parts 


Select Specific parts when you know the name of the 
part you want to observe. When you select Specific 
parts, the following prompt appears: 


Part? 


Type the name of the part you want to observe. Then, 
press <Enter> to show the part on the screen. 


The Part? prompt returns. You can display another 
part by typing its name and pressing <Enter>. If you 
press <Enter> without a part name, you return to the 
main command level. The last part displayed remains 
on the screen, ready for editing. 
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7.3.13.4 LIBRARY Delete Part 


Use the Delete Part command to delete parts from a 
library. When you select Delete Part, the following 
prompt appears: 


Part? 


To delete a part, type the name of the part and press 
<Enter>. If SET Confirm Deletion is set to No, the part 
is removed from the library. If SET Confirm Deletion is 
set to Yes, LIBEDIT asks you to confirm the deletion. 
Then, if you choose Yes, the part is removed from the 
library. 


The Part? prompt returns. You can delete another part 
by typing its name and pressing <Enter>. If you press 
<Enter> without specifying a part, the LIBRARY 
menu returns. 


7.3.13.5 LIBRARY Prefix 


Use the Prefix command to edit the library's prefix 
definition. When you select Prefix, the following menu 
appears: 


Add 
Delete 
Edit 
Quit 


ORCAD/SDT uses a library's prefix definition when you 
obtain a part with the GET command. Instead of 
entering the full name ofa part, you can enter just the 
part's suffix. For example, if TTL.LIB is one of 
ORCAD/SDT's libraries, and you enter the suffix 04, a 
pop-up menu lists the following parts: 


74LS04 
74504 
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74ASL04 
74AS04 
74HCTO04 
74HC04 
74F04 
7404 


For more information about the prefix definition, refer 
to Section 7.4.4, The Prefix Definition. 


7.3.14 MACRO 


A macro is a set of keystrokes that you attach to a 
particular key. Then, you can execute the commands 
represented by those keystrokes by pressing the 
assigned key. With the Macro command, you can 
capture keystrokes, delete macros, write defined 
macros to a file, read macros from a file, list the macros 
in a file, and erase the macros in a file (initialize the 
file). 


LIBEDIT's Macro command operates identically to 
that belonging to ORCAD/SDT. For more information 
about writing macros, refer to Section 4.1.1, MACRO. 


7.3.15 NAME 


With the NAME command, you can assign a name to a 
part that you constructed. 


When you edit an existing part from a library, it comes 
into LIBEDIT with its own name or list of names. 
Then, if you update the library with the LIBRARY 
Update Current command, you overwrite the existing 
part. 


Suppose you want instead to construct a brand new 
part. If this part is similar to an existing part, then the 
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best way to construct it is to read in the existing part, 
edit the part, rename it, and then update the library. 


A part may have a list of names. For a part to be 
unique, each member in that list must be unique. For 
example, assume that you do the following: 


e You retrieve part that has the names A, B, and C. 
e You edit the part definition. 
¢ You change one of its names (for example, C to D). 


e You add the part (now with names A, B, and D) to 
the library. 


The result is that the library now contains two parts -- 
one with the names A, B, and D (the new part) and one 
with the name C (the old part). When you add a new 
part, it replaces any existing part that has the same 
names. Because the new part doesn't have the name C, 
you don't overwrite that part. To delete C from the 
library, use the LIBRARY Delete command. 


When you select NAME, the following menu appears: 


Add 
Delete 
Edit 
Prefix 


7.3.15.1 NAME Add 


To add a name to a part, select Add. The prompt 
Name? appears. Type the name you want to give the 
part followed by an <Enter>. The prompt Sheet Path? 
then appears. Ifthe part is a sheet, type the pathname 
of the schematic file followed by an <Enter>. If the part 
is not a sheet, just press <Enter>. 
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7.3.15.2 NAME Delete 


To delete a name, select Delete. The list of names 
appears. Select the name that you want to delete. 


7.3.15.3 NAME Edit 


To-edit and existing name, select Edit. The list of names 
appears. Select the name that you want to edit. The 
prompt Name? appears followed by the current name. 
Backspace over the current name and type the new 
name followed by an <Enter>. The prompt Sheet 
Path? then appears. If the part is a sheet, type the 
pathname of the schematic file followed by an <Enter>. 
If the part is not a sheet, just press <Enter>. 


7.3.15.4 NAME Prefix 


To determine what prefixes are assumed for a part 
name, select Prefix. The list of part names appears. 
Select the part name whose prefixes you want to 
determine. The list of prefix strings defined for the 
library then appears. Beside each prefix string is a Yes 
or a No, determining whether that prefix string is valid 
or invalid for the selected part name. If you want to 
change the setting of a prefix string, first select the 
prefix string. Then, choose Yes to make the string valid 
and No to make it invalid. 


7.3.16 ORIGIN 


The ORIGIN command sets the current cursor 
position as the new XY origin. The default origin is the 
upper lefthand of the part's body. When constructing a 
part, it is often useful to redefine the origin at a point 
within the part outline. In this way, you can easily 
make relative measurements when constructing 
graphic objects. 
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7.3.17 PIN 


Use the PIN command to add, delete, or edit pins. 
When you select PIN, the following menu appears: 


Add 

Delete 

Name 
Pin-Number 
Type 

Shape 

Jump 

Zoom 

escape 


7.3.17.1 PIN Add 


To add a pin to a part, place the cursor where you want 
the new pin to be and select Add. LIBEDIT then queries 
you for the Name, Pin Number, Type, and Shape of the 
pin you are adding. 


7.3.17.2 PIN Delete 


To delete a pin in a part, place the cursor at the 
unwanted pin and select Delete. LIBEDIT then asks 
you to confirm the deletion. If you choose Yes, the pin is 
deleted. If you choose No, you return to the PIN menu. 


Note that if Confirm Deletion under the SET command 
is set to No, LIBEDIT will not ask you to confirm the 
deletion of the pin. 

7.3.17.3 PIN Name 


Use the Name command to edit the pin string 
definition of an existing pin. 
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7.3.17.4 PIN Pin-Number 


Use the Pin-Number command to change the pin 
number of an existing pin. 


7.3.17.5 PIN Type 


To.change the type of a pin, move the cursor to the pin's 
location and select Type. A menu listing the available 
pin types appears. The pin's current type is shown 
above the menu. 


Select the type that you want. The available types are 
as follows: 


Input An input pin is one to which 
you apply a signal. For 
example, pins 1 and 2 on the 
74LS00 NAND gate are input 
pins. 


Output An output pin is one to which 
the part applies a signal. For 
example pin 3 on the 74LS00 
NAND gate is the output pin 
corresponding to input pins 1 
and 2. 


Bidirectional A bidirectional pin is either an 
input or an input. For 
example, pin 2 on the 74LS245 
bus transceiver is a 
bidirectional pin. The value at 
pin 1 (an input) determines 
the state of pin 2 as well as 
others. 
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Power 


Open Collector 


Open Emitter 


Passive 
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A power pin is one that expects 
voltage or a ground. For 
example, on the 74LS00 
NAND gate, pin 14 expects 
Vcc, and pin 7 should be 
connected to ground. 


An open collector gate has the 
collector resistor omitted. This 
allows the collectors of several 
gates to be connected together 
with a single pull-up resistor. 
For example, pin 1 on the 
74LS01 NAND gate is an open 
collector output. 


An open emitter gate has the 
emitter resistance omitted. 
The proper resistance must be 
added externally. An open 
emitter gate is used with ECL 
logic and is analogous to an 
open collector gate. For 
example, MC10100 is an open 
emitter gate. 


A passive pin is typically one 
connected to a passive device. 
A passive device does not have 
a source of energy. For 
example, a resistor lead isa 
passive pin. 
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3 State A tri-state pin has three 
possible states: low, high, and 
high impedance. When it is in 
its high impedance state, a 3- 
state pin looks like an open 
circuit. For example, the 
74LS373 latch has 3-state 
outputs. 


The PIN menu then returns. You can now choose 
another PIN command or press <Esc> to return to the 
main command level. 


7.3.17.6 PIN Shape 


To specify the shape of a pin, move the cursor to the 
pin's location and select Shape. A menu listing the 
available pin shapes appears. The pin's current shape 
appears above the menu. 


Select the shape that you want. The available shapes 
are as follows: 


Line 
Clock 
Dot 

Dot Clock 
Short 


The shape Line represents a normal pin with 0.3 XY 
unit leads. Short represents a pin with 0.1 XY unit 
leads. 


The shape Dot indicates the inversion bubble while 
Clock indicates the clock symbol. The combination Dot 
Clock represents a clock symbol with an inversion 
bubble. 
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After you select a shape, the PIN menu returns. You 
can now choose another PIN command or press <Esc> 
to return to the main command level. 


The other items in the PIN menu (Jump and Zoom) 
appear in many LIBEDIT menus. They operate the 
same as their corresponding members in the main- 
level menu. escape returns you to the main command 
level. 


7.3.18 QUIT 


Use the QUIT command to exit LIBEDIT and return 
to DOS. With the QUIT command, you can also write 
to a file, update the current library you are editing, 


initialize the current LIBEDIT session, and suspend to 
DOS. 


Initializing the session means that the current part you 
are editing is removed from memory, and LIBEDIT 
requests the name of a another library to edit. The old 
library file is not updated. Any editing since the last 
library update is lost. 


When you select QUIT, the following menu appears: 


Update File 
Write to File 
Initialize 
Suspend to DOS 
Abandon Edits 


7.3.18.1 QUIT Update File 


The Update File command writes the latest copy of the 
library being edited to disk. This command is not the 
same as the LIBRARY Update Current command. 
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The procedure for modifying a library is as follows. 
First, you invoke LIBEDIT on the library. LIBEDIT 
then reads in the library into memory. Then, you 
retrieve a part definition and edit it. When you issue 
LIBRARY Update Current, LIBEDIT modifies the 
copy of the library that it keeps in memory, but it has 
not yet changed the original copy of the library on disk. 
When you issue QUIT Update File, LIBEDIT writes 
out the copy of the library in memory to disk. 


Note, however, that any corresponding library source 
file is not changed. If you want to update your library 
source file to reflect the current version of your library 
data file, you must edit the library source file 
separately. Alternatively, you could use the 
Decomposer utility on the new library data file and 
construct a new source file. 


7.3.18.2 QUIT Write to File 


With the Write to File command, you can specify the 
file to which you want to write the latest copy of the 
library being edited. When you select Write to File, the 
following prompt appears: 


Write File? 
Type in the pathname of the file you want to write to 
and press <Enter>. 


7.3.18.3 QUIT Initialize 


The Initialize command abandons the edits since the 
last file update. When you select Initialize, the current 
part is removed from the screen, and the following 
prompt appears: 


Read library? 
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Type in the name of the library file you want to edit and 
press <Enter>. 


7.3.18.4 QUIT Suspend to DOS 


With the Suspend to DOS command, you can 
temporarily leave LIBEDIT and return to DOS. You 
can then enter DOS commands. LIBEDIT remains 
suspended in memory. To return to LIBEDIT, type 


exit 


7.3.18.5 QUIT Abandon Edits 


Use the Abandon Edits command to leave LIBEDIT 
and return to DOS. 


If you have a part on the screen that contains 
specifications not currently in the library file you're 
editing or if you have made changes to the current 
library, the Abandon Edits command asks you to 
confirm your decision to leave. 


Choosing No returns you to the main command level. 
Choosing Yes exits LIBEDIT. 


7.3.19 REFERENCE 


With the REFERENCE command, you can specify or 
edit the part's reference designator. 


The default reference designator is U?A. The? is a 
placeholder for the occurrence of the device, and Ais 
placeholder for the part in a multiple-part-per- 
package device. The OrCAD utility ANNOTATE 
replaces ? with a number indicating the instance of the 
part and increments A through A, B, C, etc., once for 
each part of the package used. 
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When you select REFERENCE, the following prompt 
appears: 


Initial Reference Designator?X 


where X is the current reference designator. For ICs 
the default reference designator is U. To replace X 
with another letter or sequence of letters and numbers, 
backspace over X, type the new reference designator, 
and press <Enter>. 


To append additional letters or numbers to the 
reference designator, type them after the X and press 
<Enter>. 


Pressing <Enter> without typing anything returns you 
to the main command level. 


(eo. 208 or. 


With the SET command, you can enable and disable 
LIBEDIT options. When you select SET, the following 
menu appears: 


Auto Pan 

Backup File 
Confirm Deletion 
Error Bell 

Left Button 

Macro Prompts 
Show Body Outline 
Visible Grid Dots 


7.3.20.1 SET Auto Pan 


Auto Pan enables movement past the screen boundary. 
When the cursor crosses a screen boundary, the screen 
pans in the direction the cursor is moving. 


7-39 


Libraries Schematic Design Tools 


7.3.20.2 SET Backup Files 


When you enable Backup File, a backup file is created 
when you write or update files using the QUIT 
command. The backup file contains the previous 
version of the library being edited. 


7.3.20.3 SET Confirm Deletion 


When you select confirm deletion, LIBEDIT asks you to 
confirm a selected deletion. This gives you a chance to 
change your mind after you have selected a delete 
command. SET Confirm Deletion affects all deletion 
commands except the Body Delete command. 


7.3.20.4 SET Error Bell 


When you select Error Bell, error messages sound your 
computer's speaker. 


7.3.20.5 SET Macro Prompts 


When you select Macro Prompts, the commands 
making up your macros are displayed on the screen 
when the macro is invoked. 


7.3.20.6 SET Power Pins Visible 


When you select Power Pins Visible, the part's power 
pins appear on the screen. For example, if you set 
Power Pins Visible and display the part 74LS00 in the 
TTL library, the pins 14 and 7 appear. For the 74LS00, 
14 is Vcc and 7 is Gnd. 


Note that power pins may overlap existing pin names 


or the part name. Typically, power pins are not 
displayed. 
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7.3.20.7 SET Show Body Outline 


When you select Show Body Outline, the part's body 
outline appears as a dotted line. When you edit a part, 
you must edit within the body outline, or unpredictable 
results will occur. If you're new to LIBEDIT, it's good 
practice to display the boundaries of the part's body 
outline. 


7.3.20.8 SET Visible Grid Dots 


When you select Visible Grid Dots, grid dots are 
displayed on the screen. 


Scale 1 The grid dots appear every 
AY Unit. 
Scale Half The grid dots are still placed 


every XY unit. Because scale 
H shows twice as much detail 
as scale 1, the grid dots appear 
twice as far apart. 


Scale Quarter The grid dots are placed every 
0.1 XY unit apart. 


7.3.21 TAG 


Tags serve as destinations for a jump command. They 
are used when you want to quickly move the cursor to 
pre-defined locations. With the TAG command, you 
can set tags at specific locations in the part outline. 


Tags operate the same as with ORCAD/SDT. They do 
not appear on the part display, and they are not saved 
with the part. 


To set a tag, move the cursor to where you want the tag, 
select the TAG command, and then select a tag from A 
through H. 
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7.3.22 ZOOM 


With the ZOOM command, you can change the size of 
the part on the screen. The three possible scales are 1 
(the default), Half, and Quarter. Half scale shows more 
detail than scale 1, and Quarter scale shows more detail 
still. 


When you select ZOOM, the following menu appears 
on the screen: 


Center (1) 
In (1) 
Out (Half) 
Select 


The number or word in parentheses after Center 
indicates the current scale. 


7.3.22.1 ZOOM Center 


Center re-centers the displayed portion of the sheet 
around the cursor. This command is useful for 
centering an object on the screen so that you can easily 
edit it. 


For example, if an object is displayed partially off the 
screen, you may center it by placing the cursor near the 
object and selecting ZOOM Center. 

7.3.22.2 ZOOM In 

ZOOM In Selects the next more detailed scale (a larger 
view). 

7.3.22.3 ZOOM Out 

ZOOM Out selects the next less detailed scale (a smaller 


view) 


7-42 


Schematic Design Tools Libraries 


7.3.22.4 ZOOM Select 


ZOOM Select chooses a current scale. The selected 
scale is shown after Center. 


Selecting 1 shows the part in normal scale. Then, Out 
has no effect (you can't get smaller), and In increases 
detail to the Half scale. 


Selecting Half shows the part in 1/2 scale. Then, Out 
returns the scale to 1, and In increases detail to the 
Quarter scale. 


Selecting Quarter shows the part in 1/4 scale. Then, 
Out returns the scale to Half, and In has no effect (you 
can't get larger). 


7.3.23 Example of Using LIBEDIT 


This section shows how to create a new part and assign 
it to a new library. One of the parts used as an example 
is the time delay gate shown in Section 8, Tutorial. 


These examples describe typical uses of LIBEDIT to 
modify existing library parts and save them for use in 
the current editing session, or to a file for later use. 


Example 1 


This example changes the location of two pins on an 
existing TTL library part; a 373. Modifying a part from 
the library is something you may want to do for a 
specific design application. 


We begin by invoking LIBEDIT with the TTL library. 
Type: 


LIBEDIT TTL.LIB <ENTER> 
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You will see the message :::type any key to continue::: 
twice: once at the OrCAD startup screen, and again at 
the copyright screen. Type any key to continue. 


LIBEDIT briefly displays the message "working", then 
displays the main screen: a vertical line on the left side, 
a horizontal line across the top, the cursor arrow, and 
the screen coordinates in the upper right corner (see 
Figure 7-2) 


Figure 7-2. The Main LIBEDIT Menu 


As you move the cursor with the direction keys or 
mouse, the screen coordinates change. 


Because you made the TTL library the current library 
when you invoked LIBEDIT, bring in the 373 with the 
Get Part command. Press G, or press <ENTER>, 
move the highlight to the Get Part command and again 
press <ENTER>. 


NOTE 


The following examples assume that your 
display is set to a zoom scale of 1. 
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LIBEDIT responds with "Get?." Type "373" (no quotes), 
and LIBEDIT displays the part. In this example we will 
move the OC and G pins to the bottom of the part by 
first adding these pins at the new location, then deleting 
them at the old. 


Press <ENTER> to display the LIBEDIT main menu, 
then invoke the Pin command: press P. 


The Pin command menu options are displayed on the 
prompt line. The options are: Add, Delete, Name, Pin- 
Number, Type, Shape, Jump, Zoom, and escape. 


Notice that the cursor is positioned on the perimeter, or 
pin line, of the part. Try moving the cursor to some 
location not on the pin line. 


When the Pin command is invoked, you may move the 
cursor only along the perimeter, or pin lines, of the part. 


With the arrow keys or mouse, move the cursor to the 
lower left corner of the part, then to the right two steps 
(notice that cursor movement is in steps). The cursor 
coordinates displayed in the upper right corner of the 
screen should be (+2.0, +12.0). We'll add an OC pin at 
this location. 


Invoke the Add command by pressing A. LIBEDIT 
responds with "Pin Name?" Type "OC" (capital letters, 
no quotes) and press <ENTER>. LIBEDIT responds 
with "Pin Number?" 


Type "1" (no quotes) and press <ENTER> LIBEDIT 
responds with "Pin Type?” and displays these options: 
Input, Output, Bidirectional, Power, Passive, 3 State, 
Open Collector, and Open Emitter. 


Select Input by typing I. LIBEDIT displays these "Pin 
Shape" options: Line, Clock, Dot, Dot Clock, and Short. 
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Select Dot by typing D. LIBEDIT places the pin you 
have specified at the cursor location (you will notice 
that the pin was placed over other pins). 


Now move the cursor one step to the right, to cursor 
coordinates (+3.0, +12.0). We'll add a G pin here using 
the same steps we used to add the OC pin. 


Invoke the Add command. At the "Pin Name?” prompt, 
type "G" (capital letter, no quotes) and press <ENTER>. 


At the "Pin Number?" prompt, type "11" (no quotes) and 
again press <ENTER>. 


At the "Pin Type?" prompt, select Input. 
At the "Pin Shape?” prompt, select Line (type L). 
LIBEDIT places the pin at the cursor location. 


Now we'll delete the "old" OC and G pins. Move the 
cursor to the original pin 11 (cursor coordinates + .0, 
+11.0) and delete it by typing D. Repeat this action for 
the original pin 1 (cursor coordinates + .0, +10.0). 


Press <ESC> to return to the LIBEDIT main menu. 


Press L to invoke the Library command. LIBEDIT 
displays these Library command options: Update 
Current, List Directory, Browse, Delete Part, and 
Prefix. 


Press U to update the current part. 


If you want to save your changes to the TTL.LIB file, 
press <ESC>, then Quit. On the prompt line, LIBEDIT 
displays "Quit ttl.lib?” and a menu of options: Update 
File, Write to File, Initialize, Suspend to DOS, and 
Abandon Edits. 
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CAUTION 


Perform the following step only if you want 
to substitute the 373 just modified for the 
original 373. Otherwise press <ESC>. 


To update the TTL.LIB file, press U. 


If you want to save your changes to another file, press 
W. LIBEDIT displays "Write To?" Type a file name 
and press <ENTER> 


We have just completed the first example by modifying 
a TTL library part, perhaps for a special application. In 
this example, we moved two pins to a new location on 
the part package. 


Example 2 
This example draws a NAND gate body on a part, a 00. 
Invoke LIBEDIT as before. Type: 

LIBEDIT TTL.LIB <ENTER> 


Press any key twice to display the LIBEDIT main 
menu. To bring in the part, press G, and at the "Get?" 
prompt, type "00" (no quotes). LIBEDIT displays the 00 
part. 


Press <ENTER3>, then select the Body command (press 
B). The Body command options displayed are: Line, 
Circle, Arc, Text, IEEE Symbol, Fill, Delete, Erase Body, 
Size of Body, and Kind of Part. 


You will notice that the graphic image for the part is 
not displayed on the screen. Press E to select the Erase 
Body command. LIBEDIT displays "Erase Entire 
Graphic Body” and a NO/YES menu. Select YES. 
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LIBEDIT performs the action and places you at the top 
of the Body command menu. 


Select L for Line. LIBEDIT displays the Line command 
options: Begin, Jump, Origin, Tag, Zoom, and escape. 


With the mouse or arrow keys, position the cursor just 
below the U?A reference designator, and to the right 
above the bubble (coordinates +6.0, + .0). Maintaining 
the same X-coordinate, move the cursor down the Y- 
axis to just above the library part number (screen 
coordinates +6.0, +4.0). We can see that the arcs we 
must draw to represent the nose of the NAND gate 
must be 4 units in diameter (it must have a radius of 2 
units). LIBEDIT draws arcs in 90 degree sectors, so to 
draw the nose of the NAND gate, we must draw two 
arcs. 


Position the cursor on the left edge of the bubble (at 
coordinates +6.0, +2.0) and type O to select Origin. 
Notice that this resets the cursor coordinates to zero. 


With the arrow keys or mouse, move the cursor 2 units 
to the left (to coordinates -2.0, + .0), and up 2 units (to 
coordinates -2.0, -2.0). Select Begin. The prompt line 
displays: Begin, End, New, Jump, Origin, Tag, Zoom, 
escape. 


Now move the cursor four units to the left (to 
coordinates -6.0, -2.0) and again type B. Move the 
cursor down 4 units (to coordinates -6.0, +2.0). Type B 
again. Finally, move the cursor 4 units to the right (to 
coordinates -2.0, +2.0). Your display should look like 
Figure 7-3 below. 
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Figure 7-3. Drawing the Line Body 


Now, type E for end line. Notice that the Body menu 
appears. 


To draw the arc, type A. Move the cursor up 2 units (to 
coordinates -2.0, +0.0). Type C for center. Again, move 
the cursor up 2 units (to coordinates -2.0, +2.0). Type E 
for edge. Move the cursor 2 units to the right, and 
down 2 units (to coordinates 0.0, 0.0). Type E for edge. 


You have just defined the first arc, and your display 
should look like Figure 7-4, below. 
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Figure 7-4. Drawing the First Arc 


Now, we can draw the lower arc in much the same 
way. Move the cursor to the left 2 units (to coordinates 
-2.0, +0.0). Type C for center. Move the cursor down 2 
units (to coordinates -2.0, +2.0) and type E for edge. 
Move the cursor 2 units to the right and up 2 units (to 
coordinates +0.0, +0.0). Again, type E. Your display 
should now look like Figure 7-5. 
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Figure 7-5. The Completed NAND Gate Body 
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Press <ESC> twice. You have just completed drawing 
a NAND gate body. You may save your work, if 
desired, as outlined in the first example. 


7.4 USING THE COMPOSER AND DECOMPOSER 
UTILITIES 


Instead of using the LIBEDIT utility to create a custom 
library, you can use a text editor and the COMPOSER 
and DECOMP utilities. 


The COMPOSER utility is called COMPOSER.EXE 
and the DECOMP utility is called DECOMP.EXE. 
Both files are found on the LIBRARY disk. To execute 
either utility, you must be at the DOS command level in 
the directory that contains the utility you want to 
execute. 


COMPOSER takes a library source file, which you 
created with the text editor, and produces a library data 
file, readable by DRAFT. You may also find the 
DECOMP utility useful. DECOMP takes a library 
data file and produces a library source file. You can 
think of DECOMP as the inverse of COMPOSER. 
Creating a custom library consists of the following two 
steps: 


1. Create a library, text, or source file. The convention 
is to give the file a .SRC extension. The source file is 
an ASCII text file that contains instructions in 
OrCAD's Symbol Description Language. 


You can use any text editor. The only requirement 
is that it produce an ASCII file without any hidden 
formatting characters. For example, WordStar in 
the non-document mode produces such an ASCII 
file. 
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2. Compose the source file using the COMPOSER 
utility. This is similar to a compilation; it produces 
another file, a data file readable by DRAFT. The 
convention is to give this data file a .LIB extension. 


7.4.1. Invoking COMPOSER 
COMPOSER source library <Enter> 


where: source is the name of the 
ASCII text file that describes 
your custom parts using 
OrCAD's Symbol Description 
Language. The .SRC 
extension is a convention, not 
a requirement. 


library is the name of the 
resulting library file. If you 
give the name of an existing 
file. COMPOSER asks if you 
want to overwrite the existing 
file. You cannot append to an 
existing file. 


<Enter> represents the 
ENTER key on your 
computer. DOS commands 
are executed when you press 
<Enter>. 


Both source and library may be complete pathnames -- 
that is, if either is in a directory other than your current 
directory, you must specify the complete path. 

Consider the following example: 


COMPOSER custom.sre custom.lib <Enter> 


The files COMPOSER.EXE and custom.src are in the 
same directory, and this directory is your working 


7-52 


Schematic Design Tools Libraries 


directory. The example just shown creates the file 
custom.lib in your working directory. Here is another 
example that uses complete pathnames. 


COMPOSER \orcad\library\custom.srce 
\orcad\library\custom.lib <Enter> 


The file COMPOSER.EXE is in your working 
directory, which is not necessarily \orcad\library. This 
example creates the file custom.1lib in the directory 
\orcad\library. 


7.4.2 Invoking DECOMP 
DECOMP library source <Enter> 


where: library is the name of an 
existing library file. The .LIB 
extension is a convention, not 
a requirement. 


source is the name of the 
resulting ASCII text file that 
describes the parts in the 
specified library. Comments 
are included in the file for 
clarity. If you give the name 
of an existing file, DECOMP 
asks if you want to overwrite 
the existing file. You cannot 
append to an existing file. 


<Enter> represents the 
ENTER key on your 
computer. DOS commands 
are executed when you type 
the <Enter>. 


As with COMPOSER, both source and library may be 
complete pathnames -- that is, if either is in a directory 
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other than your current directory, you must specify the 
complete path. Consider the following example: 


DECOMP custom.lib custom.srec <Enter> 


The files DECOMP.EXE and custom.srce are in the 
same directory, and this directory is your working 
directory. The example just shown creates the file 
custom.src in your working directory. Here is another 
example that uses complete pathnames. 


DECOMP \orcad\library\custom.lib 
\orcad\library\custom.sre <Enter> 


The file DECOMP.EXE is in your working directory, 
which is not necessarily \orcad\library. The example 
just shown creates the file custom.src in the directory 
\orcad\ library. 


Note that DECOMP does not return your original 
source; it makes its own. For example, the comments 
in your original source are not reproduced. DECOMP 
adds its own comments. Also, DECOMP may 
rearrange the order of the part definitions. DECOMP 
lists parts in numeric order followed by parts in 
alphabetical order. For example, assume that you 
define two parts, one called resistor and one called 7400. 
You place resistor in your source file before 7400, run 
COMPOSER, then DECOMP to produce a new source 
file. Unlike your original source file, the new source file 
has 7400 listed before resistor. 
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7.4.3 Creating a Source File 


A source file consists of the following: 


A prefix definition 
A series of part definitions 


You can have only one prefix definition per library, and 
it occurs at the beginning of the library. 


There are two types of part definitions: block symbol 
definitions and bitmap symbol definitions. Comments 
are delimited with braces ({}). 


Block Symbol These represent parts that are 

Definitions either square or rectangular. 
These parts are typically 
memory chips, 
microprocessors, peripheral 
controllers, and many TTL 
and CMOS devices. 


Bitmap symbol These represent parts that are 

definitions complicated to define 
graphically. Instead, you 
draw them ona bitmap. They 
include such parts as resistors, 
diodes, transistors, MOSFETs, 
relays, and many others. 


7.4.4 The Prefix Definition 


OrCAD Systems specifically designed the prefix 
definition to handle the various TTL logic families. For 
example, the 74LS00, the 74S00, and the 74ALS00 have 
different prefixes (74LS, 74S, and 74ALS), but the same 
suffix (00). When you use a prefix definition, you 
reduce the memory required to store multiple families 
of parts that have different prefixes, but the same 
suffix. 
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7.4.4.1 Prefix Delimiters 


The prefix definition is delimited by the keywords, 
PREFIX and END. The initial delimiter is the 
keyword PREFIX all alone on a line. Subsequent lines 
contain the prefix definition itself. The terminating 
delimiter is the keyword END all alone on a line. 


7.4.4.2 A Prefix Definition is Required 


All source files must begin with a prefix definition. If 
you decide your custom library doesn't need a prefix 
definition, you must still supply a null prefix. A null 
prefix consists only of the delimiting keywords. 


7.4.4.3 Examples of Prefix Definitions 


Here is how a null prefix definition looks. 


PREFIX 
END 


Here is an example of a non-null prefix definition. The 
example comes from OrCAD System's TTL source 
library, TTL.LIB. 


PREFIX 

'74LS' = nS! 
wT Ase = 1% 
'74ALS' = ‘ALS 
'74AS' = nee 
ani! tu 'HCT! 
'74HC! = "HC! 
LI4ACT. has ‘ACT! 
E71 4aRC" = a 
'74F! = te 
wa 

END 


7.4.4.4 Use of the Prefix Definition 


DRAFT uses the prefix definition when you obtain a 
part with the GET command. Instead of entering the 
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entire name of the part, you can enter just the suffix. 
DRAFT displays a pop-up menu that lists all the valid 
part names constructed by appending the suffix you 
provided with the prefixes in the prefix definition. For 
example, if TTL.LIB is one of your libraries and you 
enter the suffix 04, the pop-up menu lists the following 
parts. 


74LS04 
74S04 
74ASLO4 
74AS04 
74HCTO04 
74HCO04 
74F04 
7404 


7.4.4.5 Construction of a Prefix Definition 


A prefix definition is constructed as follows: 


e First, enter the PREFIX keyword followed by a 
<Enter>. 


¢ Then, begin the first prefix string by entering a 
single quote ('). Type the prefix string. It consists of 
a string of printable ASCII characters no more than 
seven characters long. DRAFT does not distinguish 
between upper- and lower-case. Close a prefix 
string with another single quote. 


¢ Then, enter a <Space> followed by an equal sign (=) 
followed by another <Space>. To improve 
readability, you can delimit the equal sign with any 
number of <Space>s or <Tab>s. 


¢ Now enter the shorthand string. This is the part of 
the prefix string that varies. The shorthand string 
also consists of no more than seven printable ASCII 
characters. Then, press <Enter> and type the next 
line. You can define a maximum of sixteen prefix 
strings. 
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The shorthand string enables you to bypass the pop- 
up prefix menu and still enter an abbreviated part 
name. For example, you can obtain the part 
74HC04, by supplying the GET command with the 
abbreviated name HC04. This is possible because 
HC is a shorthand string for 74HC. 


¢ Close the prefix definition with the keyword END 
followed by <Enter>. 


7.4.5 The Part Definition 


The part definition defines the part's name, its size (in 
unit lengths on the screen and in tenths of an inch on 
the printed worksheet), the number of parts per 
package and the pin functions (input, output, open 
collector, etc.). 


7.4.5.1 Types of Part Definitions @ 


There are two types of part definitions: block symbol 
definitions and bitmap definitions. You don't have to 
group your block definitions and bitmap definitions 
together. For example, your source file may contain a 
block definition, followed by a bitmap definition, 
followed by another block definition. 


Block and bitmap definitions follow much the same 
syntax. A bitmap definition looks like a block definition 
followed by a bitmap. When COMPOSER sees a 
bitmap, it uses that bitmap to represent the part, rather 
than defaulting to a square or rectangle. 


7.4.5.2 Components of a Part Definition 
A part definition has the following fields: 
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¢ One or more part name strings. Anameisa 
printable ASCII string enclosed in single quotes. If 
you have more than one part name string, delimit 
them with a <Space> or put them on separate lines. 
When obtaining a part, you can use any of your 
supplied names. 


e An optional sheetpath designator. You can define a 
schematic file as a library part. This feature is 
useful for frequently used circuits. 


e An optional reference designator. The ANNOTATE 
utility automatically updates reference designators. 


e¢ The symbol size. Each unit represents a unit length 
on the screen and 0.1 inch on the printed worksheet. 
You give the X size first and then the Y size. On the 
same line you list the number of parts per package. 
If the part is a pin grid array, specify the keyword 
GRIDARRAY instead of the number of parts per 
package. 


e The pin definition. Each pin is defined on a separate 
line. A pin definition consists of the following fields: 


- The pin position 

- The pin number or GRIDARRAY pin name 

- The optional DOT keyword (which places the 
inversion bubble at the pin position) 

- The optional CLK keyword (which places the clock 
symbol at the pin position) 

- The optional keyword SHORT (which places 0.1- 
inch leads at the pin position instead of the standard 
0.3-inch leads). SHORT cannot be used with DOT 
or CLK 

- The pin function (IN, OUT, I/O, OC, PWR, PAS, 
HIZ) 

- The pin name string 
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e An optional bitmap. Use this if the symbol you want 
is not a square or rectangle. 


e An optional conversion. This only has meaning if 
you've defined a bitmap. The most common use for 
converted bitmaps is to specify the DeMorgan 
equivalent of the defined part. 


7.4.6 Block Symbol Definition 


Illustrated below is an example of a block symbol 
definition. The example does not represent a real part, 
although it is similar to a JK flipflop. Figure 7-6 shows 
the symbol produced by this block definition. 


'74EXAMP ' 

REFERENCE oc Fg «My 

6 10 2 

Ll 3 a SHORT IN J, 
LS 1 13 DOT. [CLK EN ‘CLK 
L9 2 a2 SHORT IN By 9 
B3 15 14 DOT IN 'CL" 
3 4 10 DOT IN fae 
Reb 6 "| OUT +, 
R9 5 9 OUT ot 
TO 16 16 PWR ‘NeEGs 
BO 8 8 PWR "GND! 


F LATCH?B 


74EXAMP 


Figure 7-6. The Block Symbol for 74EXAMP 
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Note the components making up the part definition. 
The first line is the part name string, 74EXAMP. The 
next line is the reference designator, LATCH. The 
third line represents the XY size and the number of 
parts per package. Lines four to the end are the pin 
definitions. 


7.4.6.1 Part Name String 


The example has only one part name string, 
‘T4EXAMP". If you want to refer to the same part with 
different names you can list a number of part names. 


7.4.6.2 Sheetpath Designator 


The example does not have a sheetpath designator. If 
your part has a sheetpath designator, you would place 
the following line after the part name strings: 


SHEETPATH ‘pathname’ 


where pathname points to a previously constructed 
schematic file. Then, whenever you place the new part 
on your schematic, you are actually placing a subsheet. 
Use sheetpath designators to represent frequently used 
circuits. 


pathname can either be a full pathname or just a 
filename. Ifit's a filename, then DRAFT assumes that 
the schematic file resides in the SHEET directory. 


7.4.6.3 Reference Designator 


After the part name string comes the optional 
reference designator. 


For this example, the reference designator would 
appear on the screen as LATCH?A. Note the question 
mark. When you run the ANNOTATE utility the 
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question mark will be replaced with a number. For 
example, if the reference designator for a resistor were 
R? and there are 16 resistors in your design, 
ANNOTATE would change the designators to R1, R2, ... 
R16. 


This example has more than one part per package, so 
the reference designator appears with an A after the 
question mark. ANNOTATE then sequences the 
letters. ANNOTATE would convert the A of the second 
part into a B. For example, after running 
ANNOTATE, the first two occurrences of the 
T4EXAMP would appear as LATCH1A and 
LATCH1B, the next two as LATCH2A and LATCH2B, 
etc. If you omit the REFERENCE line, the default 
designator U?A appears. 


What appears when you call up a part is determined as 
follows: 


1. If the device has 0 parts per package and you do not 
specify a REFERENCE key word, none appears. 
Nor does the part name appear. 


2. If the device has 0 parts per package and you specify 
a REFERENCE key word, it appears. It consists of 
the string you specified followed by a question mark. 
ANNOTATE replaces the ? with a sequential 
number. The part name also appears. 


3. If the device has one or more parts per package, and 
you do not specify a REFERENCE key word, a 
default reference designator (U?A) appears. 
ANNOTATE replaces the ? with a sequential 
number that identifies the occurrence of the device 
and replaces the A with a letter that cycles through 
the parts of a device. The part name also appears. 
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4. Ifthe device has one or more parts per package, and 
you specify a REFERENCE key word, it appears. It 
consists of the string you specified followed by ?A. 
The part name also appears. 


Figure 7-7 illustrates the relationship between the 
number of parts per package and the reference 
designator that appears on the part. You must specify a 
part name; that is what lets you extract the device from 
the library. However, the REFERENCE keyword is an 
option. If the REFERENCE keyword has not been 
specified, it defaults to U. 


NUMBER OF PARTS PER PACKAGE 


"U" IS DEFAULT 
REFERENCE 
DESIGNATOR 


NOTHING IS 
DISPLAYED 


DOES NOT USE 
"REFERENCE" KEYWORD 


z . USES REFERENCE 
pie a meta ec KEYWORD YOU ENTER 
IN SOURCE LIBRARY 


Figure 7-7. Controlling Display of Reference 
Designators 


USES REFERENCE 
KEYWORD YOU ENTER 
IN SOURCE LIBRARY 


7.4.6.4 XY Size and Parts/Package 


The next line has the three numbers 610 2. The first 
two represent the size. The size of the part is 6X by 10Y, 
where each unit represents one screen unit or 0.1 inch 
on the printed worksheet. The 2 indicates that there 
are two parts per package. If the part were a pin-grid 
array, you would supply the keyword GRIDARRAY in 
place of the number of parts per package. 
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7.4.6.5 Pin Definitions 


The rest of the example consists of the pin definitions. 
Consider the second pin position as an example. 


The first field L5 locates the pin on the left side of the 
part in the fifth position counting from the top down. 
The Y dimension was given as 10 and hence specified 
11 possible positions, 0 through 10. The first possible 
position is LO and the last is L10. The specified pin 
position (L5) is 0.5 inches from the top of the part, when 
seen on the printed worksheet. 


The next two fields for pin position L5 identify the pin 
numbers, 1 for the first part of the package and 13 for 
the second part of the package. The pin at L5 specifies 
DOT to obtain the inversion bubble and CLK to get the 
clock symbol. In this case, DOT and CLK are modifiers 
of the pin function, IN. Finally, the 'CLK’ gives the pin 
a name. 


As further examples, consider R9 and B3. RY puts a pin 
on the right side in the ninth position, and B3 puts a pin 
on the bottom in the third position counting right. The 
two power supply connections are at the top and bottom 
in the zero position. 


Note that the vertices of a part have two possible 
representations, For example, LO and TO specify the 
same pin location (the upper lefthand corner). 
Consequently, if you place a pin at TO and another at 
LO, those pins will be shorted. 


Figure 7-8 shows a grid that represents the possible pin 
positions for the 74EXAMP library part. 
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0-O-N 0 UF kwh Eco 


rey 
O 


BOTTOM 


Figure 7-8. The Grid of a 6X by 10Y Block Symbol 


Note the SHORT keyword in the L1 pin position. Pins 
with the SHORT keyword have 0.1-inch leads rather 
than the default 0.3 inches. The SHORT keyword, 

however, cannot be used with DOT or CLK keywords. 


7.4.6.6 Power Pins 


One possible pin function is PWR for power. Note that 
power pins do not appear on the screen. The NETLIST 
utility, however, does categorize all power pins that are 
connected to library parts. 


If you want to make power pins visible, change the pin 
function from PWR to IN or PAS. If you do this, you 
may notice that the power pin overlaps other pin 
names on the symbol. To avoid this overlap, you must 
reposition the power pin in the corresponding library 
source file. 
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7.4.6.7 Selectively Displaying Pins 


If the device has more than one part per package, you 
can Selectively display the pins. For example, assume 
you wanted to display the power pins VCC and GND, 
but only on the second part of the device, not on the first. 
You could do that by coding the last two lines of the 
block symbol as follows. 


TO 0 16 PAS EVGC! 
BO 0 8 PAS'GND' 


When you place this symbol on the screen, the power 
pins do not display because the first column of pin 
locations contains a 0. When you place another symbol 
on the screen, it looks identical to the first. Both are 
called LATCH?A, and neither shows the power pins. 


However, if you exit DRAFT and run the ANNOTATE 
utility with the /M option (which causes the annotation 
information to be merged into the sheet directly) and 
then look at the sheet again with DRAFT, you'll see the 
two parts labeled LATCH1A and LATCHI1B. The 
power pins appear only on the second part of the device, 
LATCH1B. 


If a device has more than one part per package, you 
may want power pins on some parts present and the 
power pins on other parts not to be present. 


This technique also works for non-power pins. By 
specifying a pin number of 0, you can cause a pin not to 
appear for the part of a package. 


But if your device has one part per package, specifying 
a pin number of 0 does not prevent the pin from 
appearing. The pin appears with a pin number of 0. 


If your device has 0 parts per package, you cannot 
specify pin numbers, and consequently, none appear. 
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Press <ESC> twice. You have just completed drawing 
a NAND gate body. You may save your work, if 
desired, as outlined in the first example. 


7.4 USING THE COMPOSER AND DECOMPOSER 
UTILITIES 


Instead of using the LIBEDIT utility to create a custom 
library, you can use a text editor and the COMPOSER 
and DECOMP utilities. 


The COMPOSER utility is called COMPOSER.EXE 
and the DECOMP utility is called DECOMP.EXE. 
Both files are found on the LIBRARY disk. To execute 
either utility, you must be at the DOS command level in 
the directory that contains the utility you want to 
execute. 


COMPOSER takes a library source file, which you 
created with the text editor, and produces a library data 
file, readable by DRAFT. You may also find the 
DECOMP utility useful. DECOMP takes a library 
data file and produces a library source file. You can 
think of DECOMP as the inverse of COMPOSER. 
Creating a custom library consists of the following two 
steps: 


1. Create a library, text, or source file. The convention 
is to give the file a .SRC extension. The source file is 
an ASCII text file that contains instructions in 
OrCAD's Symbol Description Language. 


You can use any text editor. The only requirement 
is that it produce an ASCII file without any hidden 
formatting characters. For example, WordStar in 
the non-document mode produces such an ASCII 
file. 
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2. Compose the source file using the COMPOSER 
utility. This is similar to a compilation; it produces 
another file, a data file readable by DRAFT. The 
convention is to give this data file a .LIB extension. 


7.4.1. Invoking COMPOSER 
COMPOSER source library <Enter> 


where: source is the name of the 
ASCII text file that describes 
your custom parts using 
OrCAD's Symbol Description 
Language. The .SRC 
extension is a convention, not 
a requirement. 


library is the name of the 
resulting library file. If you 
give the name of an existing 
file. COMPOSER asks if you 
want to overwrite the existing 
file. You cannot append to an 
existing file. 


<Enter> represents the 
ENTER key on your 
computer. DOS commands 
are executed when you press 
<Enter>. 


Both source and library may be complete pathnames -- 
that is, if either is in a directory other than your current 
directory, you must specify the complete path. 

Consider the following example: 


COMPOSER custom.src custom.lib <Enter> 


The files COMPOSER.EXE and custom.src are in the 
same directory, and this directory is your working 
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directory. The example just shown creates the file 
custom.lib in your working directory. Here is another 
example that uses complete pathnames. 


COMPOSER \orcad\library\custom.sre 
\orcad\library\custom.lib <Enter> 


The file COMPOSER.EXE is in your working 
directory, which is not necessarily \orcad\library. This 
example creates the file custom.lib in the directory 
\orcad\library. 


7.4.2 Invoking DECOMP 
DECOMP library source <Enter> 


where: library is the name of an 
existing library file. The .LIB 
extension is a convention, not 
a requirement. 


source is the name of the 
resulting ASCII text file that 
describes the parts in the 
specified library. Comments 
are included in the file for 
clarity. If you give the name 
of an existing file, DECOMP 
asks if you want to overwrite 
the existing file. You cannot 
append to an existing file. 


<Enter> represents the 
ENTER key on your 
computer. DOS commands 
are executed when you type 
the <Enter>. 


As with COMPOSER, both source and library may be 
complete pathnames -- that is, if either is in a directory 
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other than your current directory, you must specify the 
complete path. Consider the following example: 


DECOMP custom.lib custom.sre <Enter> 


The files DECOMP.EXE and custom.sre are in the 
same directory, and this directory is your working 
directory. The example just shown creates the file 
custom.src in your working directory. Here is another 
example that uses complete pathnames. 


DECOMP \orcad\library\custom.lib 
\orcad\library\custom.sre <Enter> 


The file DECOMP.EXE is in your working directory, 
which is not necessarily \orcad\library. The example 
just shown creates the file custom.src in the directory 
\orcad\library. 


Note that DECOMP does not return your original 
source; it makes its own. For example, the comments 
in your original source are not reproduced. DECOMP 
adds its own comments. Also, DECOMP may 
rearrange the order of the part definitions. DECOMP 
lists parts in numeric order followed by parts in 
alphabetical order. For example, assume that you 
define two parts, one called resistor and one called 7400. 
You place resistor in your source file before 7400, run 
COMPOSER, then DECOMP to produce a new source 
file. Unlike your original source file, the new source file 
has 7400 listed before resistor. 
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7.4.3 Creating a Source File 


A source file consists of the following: 


A prefix definition 
A series of part definitions 


You can have only one prefix definition per library, and 
it occurs at the beginning of the library. 


There are two types of part definitions: block symbol 
definitions and bitmap symbol definitions. Comments 
are delimited with braces ({}). 


Block Symbol These represent parts that are 
Definitions either square or rectangular. 
These parts are typically 
memory chips, 
microprocessors, peripheral ) 
controllers, and many TTL 
and CMOS devices. 


Bitmap symbol These represent parts that are 

definitions complicated to define 
graphically. Instead, you 
draw them ona bitmap. They 
include such parts as resistors, 
diodes, transistors, MOSFETs, 
relays, and many others. 


7.4.4 The Prefix Definition 


OrCAD Systems specifically designed the prefix 
definition to handle the various TTL logic families. For 
example, the 74LS00, the 74S00, and the 74ALS00 have 
different prefixes (74LS, 74S, and 74ALS), but the same 
suffix (00). When you use a prefix definition, you 
reduce the memory required to store multiple families 
of parts that have different prefixes, but the same 
suffix. 
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7.4.4.1 Prefix Delimiters 


The prefix definition is delimited by the keywords, 
PREFIX and END. The initial delimiter is the 
keyword PREFIX all alone on a line. Subsequent lines 
contain the prefix definition itself. The terminating 
delimiter is the keyword END all alone on a line. 


7.4.4.2 A Prefix Definition is Required 


All source files must begin with a prefix definition. If 
you decide your custom library doesn't need a prefix © 
definition, you must still supply a null prefix. A null 
prefix consists only of the delimiting keywords. 


7.4.4.3 Examples of Prefix Definitions 


Here is how a null prefix definition looks. 


PREFIX 
END 


Here is an example of a non-null prefix definition. The 
example comes from OrCAD System's TTL source 
library, TTL.LIB. 


PREFIX 

'74LS' = "LS’ 
"74S! = vst 
'74ALS' = ‘ALS' 
‘74AS' = "AS! 
‘74HCT' = RHGWy. 
"74HC! = LHC 
‘74ACT' = ‘ACT' 
"74AC' = INGE 
'74F! = ps 
«74! 

END 


7.4.4.4 Use of the Prefix Definition 


DRAFT uses the prefix definition when you obtain a 
part with the GET command. Instead of entering the 
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entire name of the part, you can enter just the suffix. 
DRAFT displays a pop-up menu that lists all the valid 
part names constructed by appending the suffix you 
provided with the prefixes in the prefix definition. For 
example, if TTL.LIB is one of your libraries and you 
enter the suffix 04, the pop-up menu lists the following 
parts. 


74LS04 
74S04 
74ASLO4 
74AS04 
74HCTO4 
74HCO4 
74F04 
7404 


7.4.4.5 Construction of a Prefix Definition 


A prefix definition is constructed as follows: 


¢ First, enter the PREFIX keyword followed by a ) 
<Enter>. 


¢ Then, begin the first prefix string by entering a 
single quote ('). Type the prefix string. It consists of 
a string of printable ASCII characters no more than 
seven characters long. DRAFT does not distinguish 
between upper- and lower-case. Close a prefix 
string with another single quote. 


¢ Then, enter a <Space> followed by an equal sign (=) 
followed by another <Space>. To improve 
readability, you can delimit the equal sign with any 
number of <Space>s or <Tab>s. 


¢ Now enter the shorthand string. This is the part of 
the prefix string that varies. The shorthand string 
also consists of no more than seven printable ASCII 
characters. Then, press <Enter> and type the next 
line. You can define a maximum of sixteen prefix 
strings. 
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The shorthand string enables you to bypass the pop- 
up prefix menu and still enter an abbreviated part 
name. For example, you can obtain the part 
74HC04, by supplying the GET command with the 
abbreviated name HC04. This is possible because 
HC is a shorthand string for 74HC. 


* Close the prefix definition with the keyword END 
followed by <Enter>. 


7.4.5 The Part Definition 


The part definition defines the part's name, its size (in 
unit lengths on the screen and in tenths of an inch on 
the printed worksheet), the number of parts per 
package and the pin functions (input, output, open 
collector, etc.). 


7.4.5.1 Types of Part Definitions 


There are two types of part definitions: block symbol 
definitions and bitmap definitions. You don't have to 
group your block definitions and bitmap definitions 
together. For example, your source file may contain a 
block definition, followed by a bitmap definition, 
followed by another block definition. 


Block and bitmap definitions follow much the same 
syntax. A bitmap definition looks like a block definition 
followed by a bitmap. When COMPOSER sees a 
bitmap, it uses that bitmap to represent the part, rather 
than defaulting to a square or rectangle. 


7.4.5.2 Components of a Part Definition 
A part definition has the following fields: 
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¢ One or more part name strings. Anameisa 
printable ASCII string enclosed in single quotes. If 
you have more than one part name string, delimit 
them with a <Space> or put them on separate lines. 
When obtaining a part, you can use any of your 
supplied names. 


¢ An optional sheetpath designator. You can define a 
schematic file as a library part. This feature is 
useful for frequently used circuits. 


¢ An optional reference designator. The ANNOTATE 
utility automatically updates reference designators. 


¢ The symbol size. Each unit represents a unit length 
on the screen and 0.1 inch on the printed worksheet. 
You give the X size first and then the Y size. On the 
same line you list the number of parts per package. ; 
If the part is a pin grid array, specify the keyword 3 
GRIDARRAY instead of the number of parts per 
package. 


¢ The pin definition. Each pin is defined on a separate 
line. A pin definition consists of the following fields: 


- The pin position 

- The pin number or GRIDARRAY pin name 

- The optional DOT keyword (which places the 
inversion bubble at the pin Position) 

- The optional CLK keyword (which places the clock 
symbol at the pin position) 

- The optional keyword SHORT (which places 0.1- 
inch leads at the pin position instead of the standard 
0.3-inch leads). SHORT cannot be used with DOT 
or CLK 

- The pin function (IN, OUT, I/O, OC, PWR, PAS, 
HIZ) 

- The pin name string 
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¢ An optional bitmap. Use this if the symbol you want 


is not a square or rectangle. 


¢ An optional conversion. This only has meaning if 
you've defined a bitmap. The most common use for 
converted bitmaps is to specify the DeMorgan 


equivalent of the defined part. 


7.4.6 Block Symbol Definition 


Illustrated below is an example of a block symbol 
definition. The example does not represent a real part, 
although it is similar to a JK flipflop. Figure 7-6 shows 
the symbol produced by this block definition. 


*‘74EXAMP' 
REFERENCE 
6 10 
Ll S 
LS 1 
L9 2 
B3 ais} 
TS 4 
Rl 6 
R9 3) 
TO 16 
BO 8 


‘LATCH' 


SHORT IN 
DOT CLK IN 
SHORT IN 
DOT IN 

DOT IN 

OUT 

OUT 

PWR 

PWR 


LATCH?A 


7AEXAMP 


LATCH?B 


74EXAMP 


Figure 7-6. The Block Symbol for 74EXAMP 
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Note the components making up the part definition. 
The first line is the part name string, 74EXAMP. The 
next line is the reference designator, LATCH. The 
third line represents the XY size and the number of 
parts per package. Lines four to the end are the pin 
definitions. 


7.4.6.1 Part Name String 


The example has only one part name string, 
‘TAEXAMP". If you want to refer to the same part with 
different names you can list a number of part names. 


7.4.6.2 Sheetpath Designator 


The example does not have a sheetpath designator. If 
your part has a sheetpath designator, you would place 
the following line after the part name strings: 


SHEETPATH ‘pathname’ 


where pathname points to a previously constructed 
schematic file. Then, whenever you place the new part 
on your schematic, you are actually placing a subsheet. 
Use sheetpath designators to represent frequently used 
circuits, 


pathname can either be a full pathname or just a 
filename. If it's a filename, then DRAFT assumes that 
the schematic file resides in the SHEET directory. 


7.4.6.3 Reference Designator 


After the part name string comes the optional 
reference designator. 


For this example, the reference designator would 
appear on the screen as LATCH?A. Note the question 
mark. When you run the ANNOTATE utility the 
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question mark will be replaced with a number. For 
example, if the reference designator for a resistor were 
R? and there are 16 resistors in your design, 
ANNOTATE would change the designators to R1, R2, ... 
R16. 


This example has more than one part per package, so 
the reference designator appears with an A after the 
question mark. ANNOTATE then sequences the 
letters. ANNOTATE would convert the A of the second 
part into a B. For example, after running 
ANNOTATE, the first two occurrences of the 
74EXAMP would appear as LATCHI1A and 
LATCH1B, the next two as LATCH2A and LATCH2B, 
etc. If you omit the REFERENCE line, the default 
designator U?A appears. 


What appears when you call up a part is determined as 
follows: 


1. Ifthe device has 0 parts per package and you do not 
specify a REFERENCE key word, none appears. 
Nor does the part name appear. 


2. If the device has 0 parts per package and you specify 
a REFERENCE key word, it appears. It consists of 
the string you specified followed by a question mark. 
ANNOTATE replaces the ? with a sequential 
number. The part name also appears. 


3. If the device has one or more parts per package, and 
you do not specify a REFERENCE key word, a 
default reference designator (U?A) appears. 
ANNOTATE replaces the ? with a sequential 
number that identifies the occurrence of the device 
and replaces the A with a letter that cycles through 
the parts of a device. The part name also appears. 
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4. Ifthe device has one or more parts per package, and 
you specify a REFERENCE key word, it appears. It 
consists of the string you specified followed by ?A. 
The part name also appears. 


Figure 7-7 illustrates the relationship between the 
number of parts per package and the reference 
designator that appears on the part. You must specify a 
part name; that is what lets you extract the device from 
the library. However, the REFERENCE keyword is an 
option. If the REFERENCE keyword has not been 
specified, it defaults to U. 


NUMBER OF PARTS PER PACKAGE 


“U" IS DEFAULT 
REFERENCE 
DESIGNATOR 


DOES NOT USE NOTHING |S 
"REFERENCE" KEYWORD DISPLAYED 


3 . USES REFERENCE 
BSS eas ait KEYWORD YOU ENTER 
IN SOURCE LIBRARY 


Figure 7-7. Controlling Display of Reference 
Designators 


USES REFERENCE 
KEYWORD YOU ENTER 
IN SOURCE LIBRARY 


7.4.6.4 XY Size and Parts/Package 


The next line has the three numbers 610 2. The first 
two represent the size. The size of the part is 6X by 10Y, 
where each unit represents one screen unit or 0.1 inch 
on the printed worksheet. The 2 indicates that there 
are two parts per package. If the part were a pin-grid 
array, you would supply the keyword GRIDARRAY in 
place of the number of parts per package. 
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7.4.6.5 Pin Definitions 


The rest of the example consists of the pin definitions. 
Consider the second pin position as an example. 


The first field L5 locates the pin on the left side of the 
part in the fifth position counting from the top down. 
The Y dimension was given as 10 and hence specified 
11 possible positions, 0 through 10. The first possible 
position is LO and the last is L10. The specified pin 
position (L5) is 0.5 inches from the top of the part, when 
seen on the printed worksheet. 


The next two fields for pin position L5 identify the pin 
numbers, 1 for the first part of the package and 13 for 
the second part of the package. The pin at L5 specifies 
DOT to obtain the inversion bubble and CLK to get the 
clock symbol. In this case, DOT and CLK are modifiers 
of the pin function, IN. Finally, the 'CLK’ gives the pin 
a name. 


As further examples, consider R9 and B3. R9 puts a pin 
on the right side in the ninth position, and B3 puts a pin 
on the bottom in the third position counting right. The 
two power supply connections are at the top and bottom 
in the zero position. 


Note that the vertices of a part have two possible 
representations, For example, LO and TO specify the 
same pin location (the upper lefthand corner). 
Consequently, if you place a pin at TO and another at 
LO, those pins will be shorted. 


Figure 7-8 shows a grid that represents the possible pin 
positions for the 74EXAMP library part. 
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CEFT RIGHT 


OS OPN OS We’ 


10 


BOTTOM 


Figure 7-8. The Grid of a 6X by 10Y Block Symbol 


Note the SHORT keyword in the L1 pin position. Pins 
with the SHORT keyword have 0.1-inch leads rather 
than the default 0.3 inches. The SHORT keyword, 

however, cannot be used with DOT or CLK keywords. 


7.4.6.6 Power Pins 


One possible pin function is PWR for power. Note that 

power pins do not appear on the screen. The NETLIST 
utility, however, does categorize all power pins that are 
connected to library parts. 


If you want to make power pins visible, change the pin 
function from PWR to IN or PAS. If you do this, you 
may notice that the power pin overlaps other pin 
names on the symbol. To avoid this overlap, you must 
reposition the power pin in the corresponding library 
source file. 


7-65 


Libraries Schematic Design Tools 


7.4.6.7 Selectively Displaying Pins 


If the device has more than one part per package, you 
can selectively display the pins. For example, assume 
you wanted to display the power pins VCC and GND, 
but only on the second part of the device, not on the first. 
You could do that by coding the last two lines of the 
block symbol as follows. 


TO 0 16 PAS'VCC'! 
BO 0 8 PAS'GND' 


When you place this symbol on the screen, the power 
pins do not display because the first column of pin 
locations contains a 0. When you place another symbol 
on the screen, it looks identical to the first. Both are 
called LATCH?A, and neither shows the power pins. 


However, if you exit DRAFT and run the ANNOTATE 
utility with the /M option (which causes the annotation 
information to be merged into the sheet directly) and 
then look at the sheet again with DRAFT, you'll see the 
two parts labeled LATCH1A and LATCH1B. The 
power pins appear only on the second part of the device, 
LATCH1B. 


If a device has more than one part per package, you 
may want power pins on some parts present and the 
power pins on other parts not to be present. 


This technique also works for non-power pins. By 
specifying a pin number of 0, you can cause a pin not to 
appear for the part of a package. 


But if your device has one part per package, specifying 
a pin number of 0 does not prevent the pin from 
appearing. The pin appears with a pin number of 0. 


If your device has 0 parts per package, you cannot 
specify pin numbers, and consequently, none appear. 
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Figures 7-9A and 7-9B illustrate how the number of 
parts per package, the pin number, and the 
ANNOTATE utility affect the screen symbol. 


The device 74ONE is identical to 74EXAMP, except 
that it has only one part per package. Note that the 
ANNOTATE utility affects both the pinout and 
reference designator for 74EXAMP, but only the 
reference designator for 74O0NE. 


Also note that the definition of 74EXAMP has been 
modified so that the power pins only appear in the 
second part of the package. In both 74ONE and 
74EXAMP the locations of the power pins were moved 
from TO and BO to R3 and R7, so that they would not 
overlap existing pins. 
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Before ANNOTATE 


LATCH?A LATCH?A 


7AEXAMP 74EXAMP 


LATCH’ LATCH? 


Figure 7-9A. Before Annotation 
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After ANNOTATE 


LATCHUA FS LATCH1B 


VA 


74EXAMP 7AEXAMP 


LATCH2 LATCHS 


Figure 7-9B: After Annotation 


7.4.6.8 Pin-Grid Array 


If the part were a pin-grid array, you would supply the 
gridarray pin name instead of the pin number. A 
gridarray name consists of any string of up to 15 
alphanumeric characters. 


Here is an example of a pin-grid array part definition. 
The example is the 68020 from the Motorola library, 
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MOTO.LIB. The definition is quite long so only the first 
few lines are shown. Figure 7-10 shows the resulting 
screen figure. 


'68020' 

ARs) 66 GRIDARRAY 

Ll GZ CLK IN UCLKT EN" 

L3 a2 IN TI\P\L\O\' {the \ bars the pin name} 
L4 J13 IN UNE Nii 

L5 H12 IN VINE NEN2 \ 


U4 
c >CLK ao -e4 
J12 Altes 
442q IPLO a2 +Sts 
sisd revi aa +8 
qd IPL2 A4 
AS si 
Beg avec As +8 
=k) GO BGACK AZ 3 
S3-d 8A aa +a 
32d BERR ag }ets 
d cors aro +8is 
A141 pats 
H3—q osacko A12 + E49 
d OSacK1i A13 +S4 
A14 +4 
A15 +819 
cS 
A16 
A17 +ee 
A168 +88 
K13 ai9 +35 
fate) A20 
Kee 04 aai tes 
| Sts Aa AS 
D3 a 
Mi34o4 A24 Be 
Mietos a2s5 +s 
Misito6 A26 +52 
Bio 07 A27 + Ss 
2158 A28 
Nii os A29 +e3 
29) 510 A30 
5] 933 A31 
4 4 
432— 013 TPEND bess 
21014 BG p 
81515 
MZ 016 Fco +S4 
Ne— 017 FCi FE 
D418 FC2 
S |519 
NN p20 s1zo +e 
4S— 021 SIz1}8e 
3— b22 OSEN pe? 
p23 ECS bs 
Ma 524 ocs bess 
4 025 AMC p= 
S— 026 AS Det 
= D27 os pb 
M Bee Asw tee 
D30 HALT PRE 
p31 RESET P 
66020 


Figure 7-10. The Block Symbol for 68020 


7.4.6.9 Pin String 


The pin string is delimited by single quotes. If you want 
a single quote as part of the pin string, you must use two 
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single quotes. For example, 'CLK"s' defines the string 
CLK's. Also, a backslash after the pin string name puts 
a bar over the name. 'Q\' results in Q with a bar over it. 
If you have a multi-letter pin name, you must puta \ 
after each letter. For example, the 68020 shows IPLO 
<<<don't forget the bar>>>, and the corresponding pin 
string entry in the part definition is 'I\P\L\0\’. 


Note that the power pins do not appear on the screen. 
The NETLIST utility, however, does categorize all 
power supply pins that are connected to library parts. 


7.4.7 Bitmap Symbol Definition 


Creating a bitmap is an easy way to represent non- 
square or non-rectangular parts such as resistors, 
diodes, transistors, MOSFETs, relays, and many others. 
DRAFT draws complex parts on the screen by 
selectively turning on pixel bits that represent the 
library part. Activating the correct pixel bit is 
controlled by a bitmap in the library source file you 
created. 


To define a part with a bitmap, you define the part just 
as you would if it were a block symbol, but you include a 
bitmap after the last pin definition. You can either 
draw out the bitmap with periods (.) and pound signs 
(#), or you can reference a previously drawn-out 
bitmap. “Previously drawn-out" means the bitmap was 
defined previously in the library source file. 


You would reference a previously drawn-out bitmap if 
two parts had different pinouts, but the same symbol. 
For example, the 7439 and the 7400 have the same 
symbol, but different pinouts. Assume that you've 
defined the 7400 and you're now defining the 7439. 
Instead of drawing another bitmap for the 7439, you 
can use the 7400's bitmap by including the line, 


BITMAP '7400' 
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There are four points you should keep in mind when 
creating bitmaps, as opposed to block symbols. 


1. You have to pay more attention to pin placement. 
The pin definition line and the bitmap have different 
scales, and you need to take the conversion into 
account when you draw the symbol. 


2. Although you can put a pin name in the pin 
definition, the pin name will not appear on the 
screen. The pin name will, however, be recognized 
by the NETLIST utility. 


3. A bitmap symbol gives you the opportunity to define 
a converted symbol. Bitmap devices always have a 
normal form. You have the option of also defining a 
converted form. Block symbols cannot have a 
converted form. When you use the GET command 
and extract a part from a library, it appears in 
normal form. The resulting menu enables you to 
choose its converted form instead. You define what 
the converted form is when you create the library 
source file. Typically, users define the converted 
form as the DeMorgan equivalent of the normal 
form. 


4, The maximum number of bits allowed in a bitmap is 
16,384. However, bitmaps are allocated in blocks of 
eight. So consider a bitmap that consists of 5 rows of 
33 bits. Rather than 5 * 33 = 165 bits, the space 
actually taken up by such a bitmap is 8 * 40 = 320 
bits. 


The bitmap begins after the last pin definition. A pound 
sign (#) indicates that the pixel bit is turned on, and a 
period (.) indicates that the pixel bit is turned off. 


Each . or # in the bitmap represents a screen pixel 


spacing of 0.01 inch in the X direction. Each line of the 
bitmap represents 0.01 inch in the Y direction. 
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Remember, the X and Y sizes in the part definition are 
given in units of 0.1 inch. For example, if you specify X 
and Y to be 3 and 2, your bitmap actually is 31 
characters in the X direction and 21 lines in the Y 
direction. The extra 1 results because the bitmap starts 
counting at zero. 


7.4.7.1 Example of a Bitmap 


This section contains an example of a bitmap symbol 
definition. The example is a part definition for a 
resistor. 


{Part definition for a resistor} 
"resistor' 


REFERENCE Masby 
Sh oa 0 

Ll PAS a 
Rl PAS mt 


{Top side} 


1 Di eh ecdtes oor Yad FADROERIG Colt #...#. (Right side} 


{Bottom side} 


Note that the number of parts per package is given as 0. 
Hence, there are no columns for pin numbers. The pin 
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types are PAS for passive, and there are no pin names 
(however, they may be specified). 


The X size is specified as 3; so the bitmap has lines that 
are 31 characters long. The Y size is specified as 2, so 
the bitmap has 21 lines. The part definition specifies 
two pins, one on the left in the first position (L1) and 
another on the right in the first position (R1). The pin 
positions are always spaced 0.1 inch apart. As far as the 
bitmap is concerned, pin positions are at lines 0, 10, 20, 
30, etc. 


The line numbers are enclosed in comment delimiters. 
It isn't necessary to number the bitmap lines this way, 
but doing so makes the bitmap more readable. 


You can reduce the size of bitmaps used in your library 
by observing the following rules. 


1. An empty row (one that has only dots) can be 
represented by a dot in the zeroth column. If that is 
the only character on the row, then the row is held 
as cleared. 


2. Empty rows below the actual symbol need not 
appear in the bitmap. 


3. Periods are not required after the last # in a row. 


Here is an example of the same resistor definition that 
follows the reduction rules just described. Figure 7-11 
shows the symbol that results from this part definition. 


{Part Definition for a resistor} 
"RESISTOR' 

REFERENCE Uy 

Sez 0 

Ll PAS us 

R1 PAS i 


{Top side} 
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{00}. 
{Ol}. 
1O27% 
{10'S JF. 
{04}. 
{05}. 
{06}. 


RO ee Samet eS eee | Pe SR Pou AROS {Right side} 


{Bottom side} 


“ANS 


Figure 7-11. The Symbol for a Resistor 


7.4.7.2 Conversion Bitmap 


After defining a bitmap, you have the option of defining 
a conversion bitmap. As stated previously, the typical 
use of a conversion bitmap is to supply a DeMorgan 
equivalent symbol, but more generally a conversion 
specifies another bitmap that is displayed on the screen 
whenever you choose the Convert option of the GET 
command. You can return to the original bitmap by 
selecting the Normal subcommand option. 


You begin the specification of a conversion bitmap with 
the keyword CONVERT. The conversion bitmap 
consists of pin definitions followed by a bitmap. If the 
conversion has been previously defined, you can 
reference it by including the name of the part that has 
the conversion in single quotes. 
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The next example should clarify the use of conversion 
bitmaps. First, is the definition of the 7400. Then, 
comes the conversion bitmap -- it's the DeMorgan 
equivalent of the 7400. Figure 7-12 shows the normal 
and converted symbols that result from this part 
definition. 


The 7400 has five pins, two of which are power pins 
that do not appear in the symbol. The screen size is 6 
X-units and 4 Y-units. It has four parts per package. 


The conversion bitmap uses the same XY size and parts 
per package as the normal bitmap. You must, however, 
redefine the pin types. Note the DOT keyword missing 

from the redefinition of the pin at R2. 


Also note that the conversion bitmap has the same 
number of parts per package as the normal bitmap. 
The number of parts per package determines how 
many columns of pin numbers appear in the definition. 
The converted definition must have the same number 
of columns as the norma! definition. 
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"7400! 
6 

Ll 

L3 

R2 

TO 

BO 


s) eZ IN “1 0)! 
10 1b} IN agi 
Hel DOT OUT We) 

4 14 14 PWR Bee 
wi 1 PWR 'GND' 


NRPWNP BS 
NJRPOW P&S 
[ee) 


{OOP##FFFFHFFHFEF EASES EH EHH HERA H TARR T EE EHR ES EH 


(FO) FFHFFH REAR FFF E REFERRER ERE EERSTE RRR AT HEHE HH ES HF 
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CONVERT 

L1 z 4 9 We IN Ur Oe 
L3 Z 5 10 3 IN pagan 
R2 3 6 8 att OUT co" 
TO 14 14 14 14 PWR wvVCG} 
BO 7 7 7 7 PWR "GND! 


{OOP FFHFHFFFRHFF EER FER EER A ERE EERE 

A OL oH e551 Met eh oe) chara aera ata o haat teacher tetars # ## # 

£02} soi Hi ciel at enepies slis) sifsi:sl ciaoy oie} viata’ shat eveheh ch etet Howey sot ctells ### 

LOS} SHAR oye, wher enc; coher sie suclal overoldh. seta ay-aneven alick chakel otetetelle ## 

{04 Joop st. exci. a) @ oh-ss'0) 01.0) ol ws cyinies ofan ohohictiensl deel otistoh stretotatet steele ## 
{(OSi} i Merete Bellas al ala a ehaligli ot >! of ef'el of ot chon hav once atevel oF ated chattel chet otetsnate ## 
(OG). asa erate Hisy ai'atiols. alls, 6; af stolobol eh ay stekou avonenehenstederawer an cick weer Weed Me # 
GO eR ol o, 5p 4) os. ook eyienlor oi ches orcheroneh stoned eteWatonohetch etch otal eheetaistetceRs # 


AD MER SOOO JON Oh SOI OC OUT OUOEOO OAS CO GOO AOA OHS toto HaS # 


{4O)#HFFHFHHFEEFE AHHH SE ARERR RHEE EER 


U1A U1LA 
4 at 
3 3 
2 = 
7400 7400 
NORMAL CONVERTED 


Figure 7-12. The 7400 Symbol and its Conversion 
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7.4.8 SDL Reference 


This section is a complete description of how to define a 
part in a custom library. It presents OrCAD's Symbol 
Description Language (SDL) in the form of syntax 
diagrams. A syntax diagram consists of identifiers 
(enclosed in ovals) and tokens (enclosed in rectangles). 
The syntax diagram is also followed by a textual 
representation. 


agiacent Syntax Diagram 


Figure 7-13 is an example of a syntax diagram. It 
represents the complete syntax for a library source file. 


Prefix Part 
Definition img Definition “ 


Figure 7-13. Syntax Diagram for a Library Source 
File 


To read a syntax diagram, observe the following rules. 
1. Read a syntax diagram from left to right. 


2. Every path that you follow in the direction of the 
arrows represents a correct syntax form. 


3. Junctions represent a connection point where you 
have the choice of selecting another path. For 
example, the syntax diagram for the library source 
file shown in Figure 7-13 has a junction after a part 
definition. You can choose to complete the diagram 
or to make another part definition. 
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4, You cannot continue along a path that goes against 
the arrows. For example, in Figure 7-13 after 
making a part definition you cannot choose to 
return to the prefix definition. 


5. Text enclosed in ovals represents an identifier. Text 
enclosed in squares represents a token. 


Identifiers 


Identifiers serve as placeholders for a more detailed 
level of syntax structure. They do not represent 
command syntax or tokens. Rather, they provide the 
ability to give a overview of the syntax. When you 
create the part, you must work down through all the 
nested identifiers. For example the syntax diagram for 
a library source file shown in Figure 7-13 has two 
identifiers (prefix definition and part definition) and no 
tokens. 


Tokens 


Tokens are the building blocks of a library source file. 
Just as a sentence is made up of words, a library source 
file is made up of tokens. A token belongs to one of the 
following categories: 
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¢ Numeric constants. A numeric constant consists of 
one or more whole-number digits. 


Examples: 
15 
2 
127 


¢ Character strings. A character string consists of 
one or more alphanumeric ASCII characters. 


Examples: 


e Keywords. A keyword is one of the following: 


BITMAP Takes an argument (an 
ASCII string representing a 
part name) and represents 
the bitmap of the identified 
part. 


CLK Represents the clock symbol 
in a pin definition. 


CONVERT Introduces a converted 
bitmap. With an argument, it 
refers to the converted bitmap 


of a bitmap symbol. 
DOT Represents the inversion 
bubble in a pin definition 
END Delimits the close of a prefix 
definition. 
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GRIDARRAY 


HIZ 


IN 
VO 


OC 


OE 


OUT 
PAS 
PREFIX 


PWR 


REFERENCE 


SHORT 
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Specifies that the device is a 
pin-grid array. Used in place 
of the number of parts per 
package. 


Identifies the pin as a high 
impedance (3-state) output. 


Identifies the pin as an input. 


Identifies the pin as 
input/output. 


Identifies the pin as open 
collector. 


Identifies the pin as open 
emitter. 


Identifies the pin as an output. 
Identifies the pin as passive. 


Delimits the beginning of a 
prefix definition. 


Identifies the pin as a power 
pin. The PWR keyword 
prevents a pin from being 
displayed. 


Takes an argument (an 

ASCII string representing a 
reference value). Overrides 
the default reference value. 


Specifies that the pin lead 
lengths be 0.1 inch instead of 
the normal 0.3 inch. 
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7.4.8.2 Textual Representation of Syntax 


In addition to the syntax diagram, syntax is 
represented in text. The symbols are defined as follows: 


italics Text enclosed in italics 
represents either a character 
string or a numeric constant. 


a Text enclosed in square 
brackets is optional. You 
choose whether to type it in or 
not. Do not type the square 
brackets. 


{} Text enclosed in braces is 
required. You must enter 
what's represented within the 
braces. Do not type the braces. 


; If items within square 
brackets or braces are 
separated by commas, you 
must choose one of them only. 
Do not type the comma. 


Three periods mean you can 
repeat the last item. How 
many times you can repeat 
the item depends on the 
context. Do not type the 
periods. 


Here is an example of syntax represented in text. 
pos [pin#...,grid...] 


First, you must enter a representation of pos. An 
accompanying description explains what you can put 
in for pos. The square brackets around the next item 
indicate that you don't have to enter it at all. If you do, 
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you must choose between pin# or grid; and you can 
choose a repeated number of each. 


7.4.8.3 Prefix Definition 


PREFIX DEFINITION 


Prefix 
String 


Shorthand 
L = | | 
String 


PREFIX STRING = SHORTHAND STRING 
pL See [= 
Character 
Figure 7-14. Syntax Diagram For a Prefix Definition 


PREFIX 


( prefix string’ [= ‘shorthand string’ ]] 


END 


where: 


prefix string A character string of up to 
seven printable ASCII 
characters. You can havea 
maximum of 16 prefix strings. 
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shorthand string A character string of up to 
seven printable ASCII 
characters. 

NOTES 


The equal sign must be separated by one or more 
<Space>s or <Tab>s. 


EXAMPLES 

Example 1: PREEIX 
‘Gh LS. = HS ¢ 
US AEST U = LiG 
"74ALS' = ‘ALS' 
'"74AS' = "AS" 
4acr? = CTs 
W4HC = “HCY 
'TaACT * = MAC Ls 
"74AC'! = “AC 
'"74E! = ‘rE? 
ae 
END 

Example 1: PREF IX 
END 


7.4.8.4 Part Definition 


PART DEFINITION 


Part Name 
String 


Y Size 
RangeC1..127] 


Initial Reference 
Designator String 
‘Name’ 


Number of Parts Per Package i) Pin | 
i Range CQ..165 iy Definition 7] 
GRIDARRAY 


Figure 7-15. Syntax Diagram for a Part Definition 


ee Bitmap ¥ 


Definition 
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PART NAME STRING 


Any Character 
Except ' 


Figure 7-16. The Part Name String 


‘part name string’ 

[REFERENCE ‘ef string’ ] 

X size Y size {parts /pckg, GRIDARRAY] 
pin definition 


[bitmap definition ] 
[conversion bitmap |] 


where: 


part name string A character string of up to 
seven printable ASCII 
characters that identifies the 
part. This is the string that 
can be used as an argument 
for the GET command. 


ref string A character string of printable 
ASCII characters. If present, 
the reference designator 
replaces the default reference 
designator. 
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X size A numeric constant in the 
range 1 to 127. The horizontal 
size of the part as it appears on 
a printed worksheet. Each 
entry corresponds to one unit 
length on the screen or 0.1 
inch on a printed worksheet. 


Y size A numeric constant in the 
range 1 to 127. The vertical 
size of the part as it appears on 
a printed worksheet. Each 
entry corresponds to one unit 
length on the screen or 0.1 
inch on a printed worksheet. 


parts /pckg A numeric constant in the 
range 0 to16. If you specify a 
0, the pins are not numbered 
on the symbol. 


pin definition These are identifiers for a 
more detailed bitmap 
definition level of syntax. See 
the corresponding pin 
definition entry. 


NOTE 


To improve readability, you can include 
comments within a part definition. You can 
also place blank lines within a source file. 
Typically blank lines are placed between 
different part definitions. 
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EXAMPLES 
Example 1: 
POY Peer Bae 
6 Lea ey 


pin definition 


(Two part name strings. These may be on the same or 
separate lines). 


Example 2: 


"7474" "74ALS74' '74L874' '74874' 
"74HC74' '74AC74' 

6 6 2 

pin definition 
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7.4.8.5 Pin Definition 


PIN DEFINITION 


ee Pin Number 
im Range (1..255_] A 


Pin Name 
String 


Figure 7-17. Syntax Diagram for a Pin Definition 


[pin#,grid ] [DOT ][CLK ] [[IN] pin name 
[ SHORT ] [OUT] 

(V/O] 

[OC] 

[PWR] 

[PAS] 

HIZ][ 


where: 
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pos A letter followed by a number. 
The letter is one of the 
following: T, L, R, B where: 


T indicates the top of the 
symbol. 

L indicates the left side of the 
symbol. 

R_ indicates the right side of 
the symbol. 

B indicates the bottom of the 
symbol. 


The number represents the 
distance along the indicated 
side. The distance is 
measured in unit lengths on 
the screen and in 0.1 inches on 
the printed worksheet. For 
example, if the block symbol 
were 6X by 10Y the grid used 
for placing pins is as follows. 
The figure below shows the 
location of L3. 
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ALIGHT. 


BOTTOM 


Figure 7-18. The Grid of a 6X by 10Y Block Symbol 


POSITION 
Decimal Number 
me a 
ser 


Miao 


Figure 7-19. The Position Syntax Diagram 


pin# A numeric constant 
representing the pin number. 
This is the pin number that 
appears in the screen symbol. 
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grid A letter followed by a number. 

grid represents the pin-grid 
array pin number. You can 
only choose a pin-grid array 
pin number if, in place of 
parts/pckg, you chose the 
keyword GRIDARRAY. The 
letter must be in the range A 
through S; the number must 
be in the range 1 through 15. 


GRID ARRAY PIN NAME 

Upper or Lower Case Letter DECIMAL NUMBER 
tr eccerokcar 
Figure 7-20. Gridarray Pin Name Syntax Diagram 


SHORT A keyword that places a short 
lead length at the specified pin. 
The normal lead length is 3 
screen units or 0.3 inches on 
the printed worksheet. When 
the SHORT keyword is 
present, the lead length is 1 
screen unit or 0.1 inch on the 
printed worksheet. The 
SHORT keyword cannot 
describe a pin that also has 
either the CLK or DOT 
keywords. 
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DOT 


CLK 


A keyword that places the 
inversion symbol (the bubble) 
at the specified pin location. 
The DOT keyword cannot 
describe a pin that also has the 
SHORT keyword. The 
primary use of the bubble is to 
identify pins that have logic 
negation, either at an input or 
at an output. The figure below 
shows the inversion symbol. 


> 


Figure 7-21. The Inversion DOT Symbol 


A keyword that places the 
clock symbol at the specified 
pin location. The CLK 
keyword cannot describe a pin 
that also has the SHORT 
keyword. The figure below 
shows the CLK symbol. 


Figure 7-22A. The CLK Symbol 
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You can use the CLK keyword 
in conjunction with the DOT 
keyword to produce a DOT 
CLK symbol. The figure 
below shows the DOT CLK 
symbol. 


Figure 7-22B. The DOT CLK Symbol 


IN A keyword that identifies the 
pin as an input. 


OUT A keyword that identifies the 
pin as a standard totem-pole 
output. 


VO A keyword that identifies the 
pin as a dual function 
input/output pin. 


OC A keyword that identifies the 
pin as an open collector or 
open drain. 


PWR A keyword that identifies a 
power pin, such as Vcc, Gnd, 
Vss, Vdd, and others. Power 
pins are not displayed on 
library parts when they 
appear on the screen or 
printed worksheet. However, 
the NETLIST utility connects 
all power supply pins that are 
defined in library source files. 
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PAS A keyword that identifies a pin 
as passive. Passive pins are 
typically pins on passive 
devices such as resistors, 
transistors, inductors, and 
others. 


HIZ A keyword that identifies a pin 
as a high-impedance (38-state) 
output. 
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pin name A character string that 
represents a name for the 
specified pin. For block 
symbols, this name appears on 
the screen or the printed 
worksheet. Pin names do not 
appear on the screen or the 
printed worksheet when they 
are part of pin definitions for a 
a bitmap symbol. However, 
you may still choose to use pin 
names in bitmap symbols. 
The NETLIST utility still 
recognizes them, and you may 
find them useful as personal 
references. 


You can enter pin names 
either in upper- or in lower- 
case, but they always appear 
in upper-case. 


The backslash (\) and single 
quote (’) are special 
characters. A backslash (\) 
after a character indicates 
that the character has a bar 
over it. If you want to bar 
multiple characters, you must 
place a backslash after each 
character. The single quote 
delimits the part name string. 
If you want a single quote as 
part of the pin string, you 
must escape it with another 
single quote. 
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Any Character 


Except ' and \ 


PIN NAME STRING 


Figure 7-23. Pin Name String Syntax Diagram 


EXAMPLES 

Example 1: '2114' '2148'! 
6 14 a 
Ll 5 IN "AO' 
L2 6 IN ‘Al' 
L3 iz IN vA2S 
L4 4 IN Uy Neb 
LS 3} IN 'A4' 
L6 2 IN "AS! 
L7 1 IN "A6' 
L8 Ly IN ‘AT! 
L9 16 IN 'A8! 
L10 pls} IN ‘AQ! 
L12 8 IN Cho N 
L13 10 IN 'W\E\' 
Rl 14 HIZ ‘DO' 
R2 ibs HIZ egies 
R3 12 HIZ 'p2" 
R4 ial HIZ ialsyl 
TO 18 PWR SvVeC* 
BO 9 PWR "GND' 

Example 2: '68020' 
15 66 GRIDARRAY 
Ll C2 CLK IN UCLRS 

Example 3: 


'7474' '74ALS74' '74AS74' '74LS74' 
'74S74' '74HC74' '74AC74' 


6 6 a 

L2 2 We IN *D. 
L4 3 alt CLK IN SCK 
B3 1 13 DOT IN [Che 
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7.4.8.6 Bitmap Definition 


BITMAP DEFINITION 


Bitmap 
ie Line Le 
String 


Part Name 


CONVERT a, Definition 4 at Line i 


Part Name 


Part Name 
String 


Figure 7-24. The Bitmap Syntax Diagram 


BITMAP LINE 


Figure 7-25, The Bitmap Line 


[ {.,#} ..., BITMAP ‘part name’ ,CONVERT ‘part name’ | 
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where: 
A. represents a cleared pixel 
bit that is not displayed on the 
screen. 
# A # represents a set pixel bit. 
part name A previously-defined part 
name that has a bitmap. 
NOTES 


e The maximum bitmap size is 16384 pixels. 


¢ Each pixel spacing represents 10X units and 10Y 
units. Therefore, it takes 10 bitmap pixels to 
represent one screen unit or 0.1 inch on the printed 
worksheet. Remember, pin placement is 
determined according to screen units or tenths of an 
inch. 


For example, LO identifies to a pin on the left side of 
the zeroth bitmap line. L1 identifies a pin on the left 
side of the tenth bitmap line. Pin placements are at 
lines 0, 10, 20, 30, etc. 


e The lines and character positions of a bitmap start 
numbering at 0. Hence, a symbol with X=2 and Y=3 
has 21 lines, each with 31 character positions. 


¢ Ifa line contains only periods (a clear line), you need 
only place a period in the first column. 


e You need not include clear lines at the end of a 
bitmap. 
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¢ Periods are not required after the last # in a line. 


¢ Ifyou use the BITMAP option, be sure that the part 
name you refer to is previously defined. Be aware 
that DECOMP may reorder part definitions. 
DECOMP order parts numerically and then 
alphabetically. 


EXAMPLES 
Example 1: 
"CAPACITOR' 
2 3 0 
TL PAS tt 
Bl PAS uel 
{01234567890123455678901234567890} { 0 af 2 a} 
{O10 AO. Smee or # 
(Ol, esters & ous # 
LOZ Pee cece cee # 
{ROS ere oismetetcte # 
(ODA AGT Ae ietate # 
{.0:53): welts mbes ayer ot # 
{OG iaketenccremaperes # 
{OTP # 
{OS} eee seers bre oi # 
(O'S cqeretevercc taney ats # 
TON set eat eieee aye # 
ES cries Se echt # 
f 12 a opts. ae pat saetens # 
(LI HHRHEEREEEREE EEE EHS EH 
{14}. 
(fakioig 
{16} 
tabthy, 
(LS e260 HH HEH HT HEH HE HH 
(OS oho at Hite oes cue lt talon cu catate 4 
(WALD het cease ¥ rye sce ## 
(2A neba ee hehe ton hcie s # 
(AES bs AN # 
2S stare atorsae sere # 
(OPAL RAPS Sort alsa 5 # 
(2Sibets ieee # 
(2:6 caves ce # 
AU Aas cee elise # 
UZ8 i) ee Aeasperadeerets # 
(219 wore: gerd A aes # 
(GSH D Nrcanucas Serer Cs # 


Example 2: BITMAP '7400' 
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{This takes the bitmap defined for the device 7400.} 
Example 3: CONVERT '7400' | 


{This takes the conversion bitmap defined for the device 
7400. This part must have a conversion bitmap if the 
library source file is to COMPOSE without errors.} 


7.4.8.7 Conversion Bitmap 


CONVERT 
pin definitions 


bitmap definition 


where: 

pin definition . A previously described 
identifier. Note that the pin 
definition for a converted 
bitmap must have the same 
value for parts/pckg and the 
normal bitmap. 

bitmap definition A previously described 
identifier. 

part name A previously defined part 
name that has a converted 
bitmap. 

NOTES 


If you use the CONVERT ‘part name’ option, be sure 
that the part name you refer to is previously defined. 
Be aware that DECOMP may reorder part definitions. 
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DECOMP orders parts numerically and then 
alphabetically. 


EXAMPLES 

Example 1: CONVERT 
Ll 1 4 i) 2 IN pi cop 
L3 73 5 10 V3 IN pass 
R2 3 6 8 ii OUT Koj) 
TO 14 14 14 14 PWR wVCC! 
BO 7 7 I vy PWR 'GND' 


(OOP FHHHHHHFFFFER HRA RE ERR R RRR RR RRR 


OM. iaters eteterstatrensieneieteve:cheneiein elaecinieeRereicke tte # 

TOD} H-« cre syeWarale: 0 ofalelatere ele alateuel suere teisinin seareenate # # # 

COS} Hote Hicis cl Srttamerciaiane. eel eraterarehchatererenae)aterebete eke tomers #3 

(GLO 8 Bie: A Re JAS S hORCuCIS CIO KUMI AGC Choi cunh echo -ceties tagiatas a# 

(OSH ee $20.02 RGSS Bah So Raa o here he lease teens ## 

{OG} ee) eieiais HP cla lay londe eltolonaleiey auetaus ein netenatiedecel eis tei -aNo tere te petener atte # 

OT) Sc FES ES cee eral tu otel toric otrelte re olen ovearenanene tote Conens regener ona tees ts e 

COS} CAS Ace piers metade ele leUstccatsclcamcnsctodet sce: tuoxticie eiaiceater ae aieeiere # 

{09} #5. 6.0.6% EP ee ee ee IG OAT OF ORAS # 

{1.0} $% sere EPSPS TPT ele ee era elein aie ates siovan eine a ete # 

glo s Aine A OR wise etete: 0 atsiae Saullo: alia austaeua eremare evareeg Worerotete atlelorarens .# 

iy dh ie SOR ee Coury 6 Sera seNe ais GRRE aberora he! wera ore ua telecsuoneteeteheners .# 

7S) toh HRS cis se wile oe biter rece eo ateleusiahe rele anenstaehe er a be auanerece ales sot 

{Ad} peratures Wats Bitie, biel lacie avacellaleve latahenn rors tere Be stete enti tere aleterstcreusterasTeleee # 

D'S Soave cetera choker alae 4 totale ohelic elenete evel el eels eveceriemeier siete ten share te) is ot Melenainiad atte # 
CG} vereyadenare eau acee esl alin es ote ahiouetmiete te ahevateneierane austorsierars Valiohotele ivtettere tale ete;'s # 
holt le Resta apc EiS a lavalovate’ Grace’ sis avotorerscele or sieaetctehanecpher eutueteunieleusisLereneronchcncts = 
dS} ep aiets, 3% Silat ME LOR EP is tC OOOO OI OR BORON OOO Ohh yO VS Sao ORS # 
{al Onis eiipne i, nye. ihe ia\ age) io wiacere Gohan Menus al Oo loca ait ie ete relied er ateteiavensreyeianefellevtenetexohecene # 
{E210} Take neva tetet ate HERTS PANOR MME AOS wire Riote. sole ie cevona tralia Mia eh ermlersucunte oltoretatevar steele) s # 
G2 ua ie cetshats akeiete 5 Fbycpioiw ete Pade teao ove e's 6 em Wie lalee usta ace wiislerane ote ole alferate erate: ears) = # 
12 2 Mrereneracessteyes Fore oss inve wb: mudiipe fo) sales oicas, CLG EPea OMS USD SHOIS. Gite, aiaielia oh ouai-ol.oheerave # 
{2S ACS eis clea SEE SOS eS aU Bs ors ol wi ciainl ork elatavene teres ceneke ie fone esatieltelelteNel gets # 
OES Pago ee ees Fre eke os astousies Sp ieiniaiie.aieistanckel pretensin wel otohedchonsteteraasisrats oF 
2S she Seer ees hs Bote to ceatane eters ace bw latecale la: euece lelatclele. ons wetee oksvereretetets oat 
{26 )ic. «5 ee ees Re deks 2 elem s EMC c is aleve, Gotereuelarnatelclemistenel ei eos olsks heed 

CZ LSP eS eae St a OP Oe core iar Sudievee ei eave o eradeeel metecaie ehetal ee datete: oetieners # 
K29}) Beky tet ss «Pisses 6.6 ous Ps, eee ea eiig BUNS 1d ane 16 ote cav ea seca evetecevenate sie 

{2 Di} Fon rs, Sco Hi Pies Syene else Sele Pia b's a ete. 6 die os eheustplshndlera e ehekels ee lat 

(BONE 25 GBA SSeS OES oie oN Cac OTS CIOIOIS SIDIG kG # 

(ahy Saar he oe: AE BBA Saar Raita sua rear acatel Ritece ste lela! srehetieusrets # 

UZ 20 OW Sera Becte o aver cents) sone) ote Uae Pa nen or eter eer cates paneer eenetolietssetarrs # 
CSS) c at Fie o alstare ore 6) euerens. slereane RH ROOT CID HILORNC DIGS OOD # 

ESAT SE SSS HA lot tetey ane ohare hehe o1-0's cue alin eat arena intel ccoiaoreitonewels # 

Hi yao ole Yove Eo ticke ord alhede eke aiktravauatts alee ieis ecaterora eeelerene ss encyehene ## 

{36}. F iiokcehe w aiotel el seenetane FOIE ON PRB oe ## 

(37), sich cote apwicele re sce Seteh at Odes ire Piste cearetecsostarerare ## 

STD gas POA SOs GOO Wd: eee labecede aieuede: eves locsh snersne she ### 

TESIED Be, AGAR ICEOIG « a CIENC ACR EI CIS ey eats HHH # 


(FO) FHFFHFFFFFRFEEE RETR EER ERE HEH HEHE 


Example 2: CONVERT '7400' 
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7.4.8.8 A Final Example: Making a Connector 


A typical custom part is a connector. 


You could use module ports to make a connector, but 
OrCAD Systems doesn't recommend it. If you use 
module ports to represent a connector, the NETLIST 
utility has no way of knowing what the pin numbers 
are. Instead, use module ports to represent 
hierarchical and flat file signals that go from one sheet 
to another. 


Connectors, such as the DB25 or the IBM 62-pin edge 
connector, are best represented as library parts. In that 
way, you treat connectors as physical devices with pin 
names, which is what they are. 


Here is a partial example of a part definition for an 
IBM 62-pin edge connector. 


‘CONNECTOR IBM' 
10 32 0 


Ll PAS ‘Bis 
L2 PAS “B20 
is PAS We}shl 
L4 PAS BAN 
L5 PAS U)toyy 
L6 PAS *B6! 
L30 PAS PE SiOn 
L31 PAS viekehaly 
Rl PAS VAL 
R2 PAS "A2' 
R3 PAS CAS} 
R4 PAS vA: 
RS PAS VASE 


R6 PAS ‘A6' 


R30 PAS TAS 0} 
RS. PAS SAS le 
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7.4.9 Examples of Source Libraries 


Using the techniques just described, we can now 
examine some examples of library source files. 
Remember, comments are enclosed within braces {...}. 
We present three sample source libraries. 


SAMPLE_1.SRC This file contains some typical 
block symbol definitions. It 
has some memory devices and 
two microprocessors, the 
8086MAX (the 8086 in 
maximum mode) and the 
68020 (a pin-grid array). 


SAMPLE_2.SRC This file contains some 
standard TTL devices. Note 
the use of a prefix definition. 


SAMPLE_3.SRC This file contains some typical 
bitmap definitions. It has an 
AND gate with its DeMorgan 
equivalent, an antenna, a 
capacitor, a triode, and other 
non-square or non- 
rectangular symbols. 


Although these examples separate the kinds of 
definitions (block from bitmap) into different libraries, 
that is not a requirement. You can intersperse block 
and bitmap definitions in the same file. 


To use these sample files, construct a pure ASCII file 
(no formatting characters) and execute the 
COMPOSER utility. Then reconfigure DRAFT to 
recognize the new library. For example, to compose the 
sample files, enter the following commands on the DOS 
command line. The file COMPOSER.EXE and the 
sample files must be in the same directory. 
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COMPOSER SAMPLE 1.SRC SAMPLE 1.LIB <Enter> 
COMPOSER SAMPLE 2.SRC SAMPLE 2.LIB <Enter> 
COMPOSER SAMPLE 3.SRC SAMPLE 3.LIB <Enter> 


Then, reconfigure DRAFT, as outlined in Section 2. 
You can add one or more of the resulting library files. 
DRAFT expects the library files to have a pathname 
constructed by placing the library prefix (set with the 
LP command) before the library file (set with the LF 
command), 


7.4.9.1 SAMPLE_1.SRC: A Block Symbol Library 
Source File 


{Beginning of source file, SAMPLE _1.SRC} 
PREFIX 
END 


{The following are memory devices} 


{1K x 4 static RAM} 


“2ig4a* 42148" 9'2249% 5513 '§574a" +9344: 
Toast 

6 14 al 

Ld 5 IN RO 
L2 6 IN Ae 
VBS v IN Aa 
L4 4 IN ha" 
L5 3 IN eA Oe 
L6 2 IN ab) oi 
pe) 3) IN “Age 
L8 17 IN ‘Ad 
L9 16 IN ‘A8' 
Idd 15 IN "AQ! 
Hi2ey 8 IN “CX Sae 
pigs AE 6) IN "W\E\' 


Rl 14 BIZ "DQ" 
R2 13 H1IZ aie 2 ig 
R3 12 MiZ. “DZ* 
R4 ad 1 Ye eh © eS 
TO 18 PWR! eave CG. 
BO 9 PWR ‘GND! 
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{All of the above memory devices have the same block 
symbol. The part's size is 6X by 14Y, and it has one part 
per package.} 


{256K x 1 dynamic RAM} 

"2.250" ao hoaceoote a! 50256). 4 S005 7% aatel25G)  Waaoe7s 
POLS MEMUC Zoe S42 56 ala OS phe eral 2 SG ees 7 2516s 

6 14 AL 


Ll 5 IN "AO! 

L2 7 IN "AL 

L3 6 IN ‘A2' 

L4 2 IN JUNI 

L5 ish IN "AG! 

L6 10 IN ‘AS! 

yg) 13 IN "AG! 

L8 9 IN ‘AT! 

L9 1 IN "A8! 
L11 4 IN "R\A\S! 
L12 15 IN 'C\A\S\! 
L13 3 IN 'W\E\'! 
Rl 14 HIZ "DO! 

R3 2 IN ely 

TO 8 PWR Nierert 
BO 16 PWR USSU 


{The following are microprocessor devices} 


*8086MAX' 

13 32 1 

R1 16 I/O ‘ADO' 

R2 LS I/O “ADA 

R3 14 I/O "AD2Z: 

R4 ans} I/O "AD3' 

RS iP I/O "AD4' 

R6 bal I/O PAD SE 

R7 10 I/O ‘AD6' 

R8 9 L/ Oo AD aN 

R9 8 I/O "AD8' 
R10 7 I/O VAD OF 
Rll 6 I/O "AD10' 
R12 Ss I/O ‘AD11' 
R13 4 I/O "AD12' 
R14 3 I/O "AD13' 
R15 2 I/O "AD14' 
R16 39 I/O ‘AD1S' 
R17 38 OUT ‘A16/S3' 
R18 SW OUT ‘A17/S4' 
R19 36 OUT VAI87S5" 
R20 35 OUT "A19/S6' 
R22 34 OUT BNE \Y/ Si! 


R24 26 DOT OUT JSOL 
R25 Zi DOT OUT US 
R26 28 DOT OUT SoZ" 
R28 32 OUT "R\D\' 
R29 29 DOT OUT "LOCK" 
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R30 ZS 
R31 24 
L3 Pape 
L4 19 
LS Pan 
L7 18 
L27 31 
L28 30 
L29 iby 
L30 23 
Lote so 
TO 40 
BO. 20 
BS 1 


CLK IN 


DOT 
DOT 


DOT IN 


Foso'' 
'QS1' 
"READY' 
"CLK' 
"RESET' 
‘INTR' 
"RQ/GTO' 
"RQ/GT1' 
‘NMI' 
STE one 
"M\x\! 
EVCC® 
‘GND! 
‘GND' 


{End of source file, SAMPLE_1.SRC} 


7.4.9.2 SAMPLE_2.SRC: A TTL Block Symbol 


Library Source File 


{Beginning of the source file, SAMPLE_2.SRC} 


PREFIX 
WIaOM 
'7T4S' = 
"74ALS' 
'74AS' 
'74HCT' 
"74HC' 
"74ACT' 
"74AC! 
'74F! = 
‘74° 
END 


"7446! 


Se 

oy 
POANRPYWU Bb @ 
ny 


yy) 
® OD 
Por 
oOo” Gh 


" 
ES 
n 


Se 


ae ee ae 
x 
Q 


"74475 


'74LS47! 


'R\B\O\' 
'R\B\1\! 
PAT? 

Lio IL 

2! 

tq! 

8! 

"Gs 

tp 

‘Bp! 

‘pp! 
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R3 al DOT Oc ey 

R2 12 DOT oc ne 

Rl als) DOT oc PA 

TO 16 PWR rVECE 

BO 8 PWR "GND! 
"7474! '74ALS74' '74AS74!' '74LS74'° '74S74' 
'74HC74' '74AC74! 

6 6 2 

L2 2 a2 IN ayy 
L4 3 tal CLK IN Be Ks 
B3 1 ES DOT IN "CL! 
13 4 10 DOT IN Mp. 
R4 6 8 OUT LONG 
R2 5 9 OUT Oe 
TO 14 14 PWR NAGY 
BO 7 7 PWR "GND! 


{This part has two parts per package. The far left 
column represents the pin position. The second column 
contains the pin numbers of the first D flip-flop in the 
package. The third column contains the pin number of 
the second D flip-flop in the package. Note the power 
pins on 14 and 7. They are required for both devices.} 


{End of the source file, SAMPLE_2.SRC} 

7.4.9.3 SAMPLE_3.SRC: A Bitmap Symbol Library 
Source File 

{Beginning of the source file, SAMPLE_3.SRC} 


PREFIX 
END 
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"7400! 
6 4 4 

Ll 1 4 9 eZ IN Jago 
L3 2 S 10 us IN J 
R2 3 6 8 ial DOT OUT BOM 
TO i 14 14 14 PWR VGC 
BO 7 7 7 7 PWR "GND ' 
(OO)F#HHHHHHFT RAFF FF RRR e eH HHT HR FERRE eR HEHE RR RRR RH 

AO SAR SOA! 0 IMU Oe 2, Satna eek a AY ae ..HtF 


(SOE Ee Seteinvs sore os actos CREMEE ABE SSESPSAGAE SEES ED ES ##F 
(40) #ethaF RRR RR HERR e RR THT H FRG ERE GEE RRE EHR ER HRS 
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4 9 iy IN HOM 

5 10 13 IN eae 
R2 8 6 8 11 OUT HO’ 
TO 14 14 14 14 PWR eVCCu 
BO 7 gz U d PWR "GND ' 
{OOS HHHFFFFTERRER REPRE REAR RRS RRR 


{US'S Fete tellers cla itete terete eral a elsiore enelersiorareeneretsert Ht # 
{OS HFFFFEEFFEFFF REESE RHR A ERE S RSH EHH 
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{The following are electrical and electronic parts} 


‘ANTENNA! 
2 iL 0 

Bl OUT ‘ANT! 

{ O}###HHHHHHHHHE HHH HH HHH 
CRE HEE Oe caw ostaoers eae ae #. 
Ue Ziliens Marais: i RORG ORE Oye Rss 
UME Su} louewenten oxo aes LAOS ere # 

(Pera hee t Modi dope Se ctretha Ree # . 

LF ots) Uae ae # te Ae eee 
lin 26s st oS 2 # que tiss tis. ch: 
(Ril meee see oc A Pain ea ee 
Le yi) Rear he Se RTE ADR) Yes 
Ce ere he ACR Bac ae 
COROT ere nie pty PO eee 
‘CAP! 

"CAPACITOR' 

REFERENCE 'C'! 

{X Size =} 2 {Y Sizer=) 71 {Parts per Package =}} 0 
yal SHORT PAS Dae 

Bl SHORT PAS UPAU 
(RMON ersten ieee bck aicaatn yer 
(EL eae eee. HOG it Cuno ICG 
{ 2) .##HHHHHEHHSHR RR HH EH 
CHS ert at tee ee ee 
Etre Ss .th ROO 
Oe Te Se ae ee 
CO ota Satees secs eee lee os 
(FQ. aeons HHHHHHHHE. OL. 
cog CM ena Fe vee aes ### 

LOR aes FS yeaa fine ee eae. ais ## 
tM Or eorsee ernest Hactawels cert Bast oie 
‘GND POWER! 

{X Size =} 2 {Y Size =} 1 {Parts per Package =} 0 
Bua PWR ‘GND! 

{ O}F##HHEHHHHHHH HHH HHH HH 
CPR crores aS ct Oct cuee ee 
LSE Zhaee Rael ts vote nae, © 
{ 3)... ##HEHHHHEHH HEHE. 
PRIN i Serr i Toy 
{& OS ee Saker. Lue, oe’: 
5) Nes HHEHRHHHH. OL. 
le ARS rs Ck EN a RO 
CSeOD cieihanete tines co icis esate ss 
(2RES)} ee eas Fitithia) cettencne meee 
Wat ee etec rr Wes Beet: cals atin, 
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8. TUTORIAL 


This section is a step-by-step tutorial that shows how to 
create a schematic worksheet and take advantage of 
the OrCAD utilities. The tutorial creates a simple one- 
sheet schematic for a portion of a memory-decode 
circuit. The circuit is similar to that found in the IBM 
PC and compatibles. 


This section assumes that you have configured 
OrCAD/SDT III. That is, you have invoked DRAFT 
with the configuration option (/C) and specified the 
directory that contains the display and printer drivers, 
the directory that contains the library files, the 
directory that will contain the worksheets, and the 
pathname of an optional macro file. You have also 
added the names of the library files you intend to use in 
your design. These names may include custom 
libraries that you have written. 


The section is divided into three modules. Each module 
contains step-by-step instructions, set off from the text 
with the identifier Action:. If you follow those 
instructions, you'll end up with a one-sheet schematic 
of the memory-decode circuit. Figure 8-1 shows the 
worksheet at the conclusion of Module 1, and Figure 8- 
2 shows the worksheet at the end of Module 2. 


The accompanying text describes the instructions in 
more detail and occasionally presents alternate 
methods. The intent is to demonstrate the power of 
OrCAD/SDT III while still keeping the example simple 
and straightforward. 
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8.1 Assumptions 


Hard Disk. When describing the directory structure 
recommended for hard disk users, this section assumes 
that you have configured DOS to show the directory 
structure as part of your prompt. For example, the 
default prompt for drive cis C>. Ifthe directory 
C:\ORCAD is your working directory, this section 
assumes that your prompt is C:\ORCAD>. To 
configure DOS this way, issue the DOS command, 


C>PROMPT$P$G 


If you prefer, include this line in the file autoexec.bat 
and place it in the root directory of your boot device so 
that the configuration takes place automatically every 
time you boot up. 


Mouse. Although not required, a mouse makes life 
much easier. This example assumes that you have a 
mouse with its driver installed. 


OrCAD/SDT III makes use of the left and right mouse 
buttons. If your mouse has a middle button, you may 
define it as a macro key. The left mouse button 
executes <ENTER> and the right mouse button 
executes <ESCAPE>. 


If you are not using a mouse, you can execute 
<ENTER> by pressing the <RETURN> key and 
<ESCAPE> by pressing the <ESC> key. Typing 
<RETURN?> after invocation brings up the main 
command menu. You can then execute a command by 
typing the first letter of the command name. You can 
also highlight the command to be executed by moving 
the highlight with the directional arrow keys and then 
choosing the highlighted command by pressing 
<Return>. 
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Printer. This tutorial assumes that you have an 
attached printer. That is, you have configured 
OrCAD/SDT III with the appropriate printer driver 
and that your printer is connected to the first parallel 
port, LPT1. 


You can also use the PRINTALL utility to print your 
schematics. If you are using a plotter instead of a 
printer, you cannot use the HARDCOPY command. 
The PLOTALL utility is used to plot your schematics. 


8.2 Requirements 


The example requires that you have configured 
OrCAD/SDT III with all of the OrCAD supplied TTL 
libraries and the DEVICE.LIB library. In module 2, 
you will create a custom library, which will then have 
to be configured with the system. 


Module 1: TTL.LIB 
Module 2: TTL.LIB, DEVICE.LIB, a custom 
library 


The custom library in Module 2 consists of one 
component. The module describes how to create the 
custom library. 


8.3 Module 1: Constructing a Worksheet, Part 1 
Summary: This module consists of invoking DRAFT, 
Setting its environment, extracting some parts from the 


appropriate libraries, editing the reference block, 
Saving the work sheet, and making a hardcopy. 
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The Worksheet after Performing Module 1 


Figure 8-1. 
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8.3.1. Invoking DRAFT 


When you first begin your design, you must specify a 
worksheet. Note that you need not specify the complete 
pathname of the worksheet. If you specify only a 
filename, DRAFT assumes that your worksheet resides 
in the directory that you specified as the worksheet 
prefix during configuration. You can, of course, 
override the default you supplied during configuration 
by giving a complete pathname. 


Specify a worksheet in one of three ways. The following 
examples assume that TUTOR.SCH is the name of 
your worksheet. 


1. Include the name of your worksheet on the 
invocation line. If the file already exists, DRAFT 
brings it in for editing. If the file does not exist, 
DRAFT uses the name you supplied when you 
update or write the file. If you abandon without 
editing (that is, choose the Abandon Edits 
command without having updated or written the 
file), the file will not exist. 


C:\ORCAD>DRAFT TUTOR.SCH 


8-5 


Tutorial Schematic Design Tools 


2. Specify the name of your work file when DRAFT 
requests a load file. If you invoke DRAFT without 
a worksheet, you receive the prompt load file? 
after the company logo and the copyright 
message. Respond with the name of your 
worksheet. 


C:\ORCAD>DRAFT 


<OrCAD logo appears; type any key to continue.> 
<Copyright information appears; type any key to 
continue.> 


load file? TUTOR.SCH 


3. Specify the name of the file when you update it or 
write it. If youinvoke DRAFT without a 
worksheet and respond with an <ENTER> when 
DRAFT requests a load file, DRAFT assumes you 
are working with an unnamed worksheet. If you 
choose to write that unnamed worksheet to a file, 
DRAFT requests the name of the file. 


C:\ORCAD>DRAFT 
<Respond with <ENTER> when load file? 
appears. Construct the file. Choose the QUIT 


command. Choose the Write command.> 


Write to file? TUTOR.SCH 
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Action: Invocation. Enter the OrCAD directory. 
This tutorial assumes that the directory is 
C:\ORCAD. Issue the command: 


C:\ORCAD>DRAFT 


When the logo appears, type any key. 
Then, when the copyright information 
appears, also type any key. Then, when 
the prompt load file? appears, type 
TUTOR.SCH followed by an <ENTER>. 


8.3.2. Setting the DRAFT Environment 


You are now in DRAFT. Displayed on the screen, are 
the top and left lines that define the worksheet. On the 
prompt line is the message <<New Worksheet>>. 
Because the screen is smaller than the worksheet size, 
the other two defining lines (the right and bottom) are 
off screen. You can think of the screen as a window into 
the worksheet area. 


DRAFT is invoked with a default environment. To see 
what that environment is, invoke the SET command. 


Action: Looking at Environment Settings. Press 
the left button on your mouse. The main 
command menu appears. Select the SET 
command. That is, move the mouse to 
highlight the SET command and press 
the left button. The SET menu appears. 


How you set DRAFT's environment is often a matter of 
personal preference. For example, Auto Pan's default is 
YES. This means that when you move the mouse past 
the edge of the screen, the screen follows to the new 
worksheet area. 
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remove the menu from the screen by 
pressing the right button on your mouse. 
This is equivalent to pressing the <ESC> 
key. Then, move the mouse to the lower 
right corner and keep moving it until the 
title block appears. The screen will pan to 
keep up with your mouse. 


If you set Auto Pan to NO, the screen will 
not pan; but you can still get to different 
parts of your sheet by invoking the 
JUMP command. 


Now move the mouse to the upper left 
hand corner, returning the screen to its 
original location on the work sheet. 


Press the left button. The main 
command menu appears. The highlight 
is on AGAIN. Select the AGAIN 
command by pressing the left mouse 
button. This executes and repeats the last 
command that you invoked. Because 
that command was SET, the SET menu 
reappears. 


More SET Options 


Backup File determines whether or not a backup file is 
produced. With this option set, your disk will have two 
work files when you exit DRAFT, TUTOR.SCH (the file 
you created) and TUTOR.BAK (the backup file). The 
backup file is the resulting file from your last edit 
session. If you're editing a brand new file (as in this 
example), you of course, won't have a backup. Unless 
your disk space is severely limited, it is always good 
practice to let Backup File remain at YES. 
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Drag Buses enables the rubberbanding of buses. This is 
in addition to rubberbanding of wires, which is always 
enabled. Rubberbanding buses is a feature you should 
use only when necessary. DRAFT has to keep track of 
many more points when dragging buses, and you may 
notice a decrease in performance. 


Error Bell determines whether or not your computer's 
bell sounds when you try to do something illegal. How 
. you set this option is a matter of personal preference. 


Leave the Left Button set to the default, NO. Although 
setting Left Button to YES does speed up some mouse 
commands, this tutorial assumes that it is disabled. 


With Left Button set to YES, you can skip a button press 
when executing some mouse commands. For example, 
you can call up a menu by pressing the left button and, 
while being careful to keep the left button down, 
highlight the command you want to execute by moving 
the mouse. You can then execute the command by 
releasing the button. Contrast this with pressing the 
left button to get the menu, highlighting the command, 
and pressing the button again to execute the 
highlighted command. 


After you become experienced with macros, you may 
want to set Macro Prompts to NO. Leaving it at YES, 
gives you more feedback about what's going on when 
you execute a macro. 


Setting Orthogonal to NO, enables you to draw wires at 
arbitrary angles. By default, wires are drawn 
orthogonally (that is, they are drawn either 
horizontally or vertically), and turns are always at 
right angles. 


Show Pins determines whether or not the pin numbers 


on devices are shown. If Title Block is NO, the title block 
in the lower right hand corner is disabled. This is the 
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same title block you looked at when you tried out 
autopanning. You may want to disable this default title 
block and construct one of your own. 


Leave Worksheet Size set at A. This restricts your 
worksheet to 8.5 by 11 inches unless you changed the 
Template Table when you configured OrCAD/SDT III. 
The actual working area is, of course, somewhat 
smaller due to space allocated to the border. X,Y 
Display defaults as NO. Change it to YES. 


Action: Setting X,Y Display to YES. Move the 
mouse so that the highlight is on X,Y 
Display. Press the left button. Place the 
highlight on YES and press the left button 
again. Move the mouse in any direction 
and observe the XY coordinates in the 
upper righthand corner of the screen. 


This is a good time to get a feel for the size of your \€ 
worksheet. The units are inches on the printed 

worksheet. The upper left corner is 0,0; the upper right 

corner is 9.50,0.00. Therefore, the maximum X 

distance is 9.50. The lower left corner is 0.00,7.00. 

Therefore, the maximum Y distance is 7.00. It comes 

as no surprise that the lower right corner is 9.50,7.00. 


Grid Parameters 


If you select Grid Parameters from the SET menu, 
three choices will be displayed: Grid References, Stay on 
Grid, and Visible Grid Dots. Selecting any of the three 
produces a YES/NO menu. Each toggles an 
environmental setting. 


€ 
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Action: Making the Grid Visible. Press the left 
button. The highlight ison AGAIN. Press 
the left button again, and the SET menu 
appears. 


Select Grid Parameters; by placing the 
highlight on Grid Parameters and press 
the left button. Then, select Visible Grid 
Dots. Then, select YES. The grid appears 
on the screen. The spacing between the 
dots represents 0.1 inch on the printed 
worksheet. 


Return to the main command menu by 
pressing the left button. Select AGAIN, by 
pressing the left button once more. 


Setting Grid References shows the vertical and 
horizontal sheet coordinates. For reference purposes, 
the worksheet is divided into blocks. The horizontal 
direction goes left to right from 8 to 1, and the vertical 
direction goes top to bottom from D to A. For example, 
the title block is located at A,1. Setting Grid References 
to YES shows the D through A and the 8 through 1 
along the edge of the worksheet. 


The other choice, Stay on Grid, gives you finer control 
over the cursor. When DRAFT is set for on grid, the 
cursor always points to one of the grid dots. When Stay 
on Grid is set to YES, you can't put the cursor in 
between dots. However, going off grid is dangerous and 
should only be used when absolutely necessary. When 
you are off grid, it's more difficult to make good wire 
connections. What may look like a connection on the 
screen may not be a connection when interpreted by 
the ERC and NETLIST utilities. 


The final choice in the SET menu, Repeat Parameters, 
is best left as an advanced topic. Refer to Section 4, 
Commands, for more information. A typical 
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application occurs when you need to produce a series of 
similar labels -- for example, address signals labeled AO 
through A7. 


Action: Closing the SET menu. Press the right 
button. 


So far you have invoked DRAFT and set the 
environmental parameters. You have chosen the XY 
display in the upper righthand corner and made the 
grid dots visible. Now, it's time to get some parts. 


8.3.3. Using the Libraries 
This module uses parts from TTL.LIB. 


Action: Extracting a Part from a Library. Press 
the left button. Move the mouse ta 
highlight the GET command. Press the « 
left button. The Get? prompt appears. 


Press the left button again. You see a list 
of the configured libraries. Select 
TTL.LIB; that is, put the highlight on 
TTL.LIB and press the left button. A part 
list appears. Scroll down through the 
part list by moving the mouse until the 
highlight is on 138. Then, press the left 
button. Another menu appears. Select the 
74LS138. 


You have extracted the part 74LS138 from the library. 
You can see it on your screen, but it's not yet part of 
your worksheet because you haven't "placed" it. The 
part moves with your mouse. When it moves, it 
appears as an outlined symbol. This is a part symbol 
with much of the detail removed. If you let the mouse 
stay in one position for a few seconds, the detailed part 


4 
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appears, only to become the outlined symbol again if 
you move. 


Action: Placing the Part on the Worksheet. 
Move the mouse until the XY coordinates 
in the upper righthand corner read 1.80, 
2.40. Then, press the left button. Another 
menu appears. The highlight is on Place. 
Press the left button again and move the 
mouse. The part is now placed in the 
worksheet, and you have another 
outlined symbol. At this point, you're 
ready to place another copy of the part. 


Move the symbol until the XY 
coordinates read 3.00, 3.90. Press the left 
button twice to place another symbol on 
the worksheet. 


Now, press the right button. This returns 
you to the main command level. 
Although you are at the main level, the 
main command menu does not appear 
until you press the left button. 


When you selected the library TTL.LIB, you saw a list 
of the shorthand strings contained in the library. 
Shorthand strings are the part names without the 
prefixes. When you selected 138, another menu 
appeared. This one listed all the valid parts, constructed 
by adding the valid prefixes to 138. 


Instead of going through the menus, you could instead 
have typed in the complete part name at the Get? 
prompt. For example, you could have typed 74LS138. 
DRAFT would then search through the configured 
libraries and deliver the part; DRAFT would search the 
libraries in the order you followed when you added 
them during configuration. If, at the Get? prompt, you 
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type 138, you see the menu that lists all the valid parts 
with 138 as a suffix. 


Deleting Parts 


You now have two parts on the worksheet. At this 
point, you could delete or move them. To delete a part, 
select the DELETE command from the main 
command menu. This displays the DELETE menu, 
which displays three options: Object, Block, and Undo. 
If you want to delete a part, select the Object 
subcommand and move the mouse until the cursor is 
placed on the part you want to delete. 


Now, you can delete the object in two ways. You can 
press <d> on your keyboard. Or you press the left 
button twice, once to display the menu and again to 
choose Delete. If you had set the environmental 
characteristic Left Button to YES, pressing the left 
button once would accomplish the same result. 


Because of the way the deletion is done, some dots may 
remain on the screen. They are not really on the 
worksheet. Pressing the <ESC> key or the right button 
causes the screen to redraw, and the extra dots 
disappear. 


Don't be hesitant about deleting one of these parts just 
for practice. You can restore the part by selecting 
DELETE from the main command menu and Undo 
from the DELETE menu. 


Moving Parts 


The Move command is part of the BLOCK menu. You 
can move an object or define an arbitrary block on your 
worksheet for moving. For example, to move one of the 
74LS138 decoders, perform the following steps. 
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Select the BLOCK command from the main command 
menu; that is, highlight BLOCK and press the left 
button. From the BLOCK menu, select Move. The 
commands now available for execution are listed across 
the top of the screen on the prompt line. 


Put the cursor on the object you want to move. Then, 
press the left button to get the subcommand menu. 
Select Begin. Another set of commands appear across 
the prompt line. Press the left button to get the menu 
and select End. Now, move the mouse to new location, 
notice that the part follows. Press the left button twice to 
place the part in the new location. 


If you practice moving one of the decoders, be sure to 
put it back at the designated location. 

Placing Five More Parts 

You can place these parts the same way you did the 


74LS138. You want to place four 74LS08's and one 
74LS00. 
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Action: Extracting A Part from TTL.LIB. From 
the main command menu, select GET. 
Then, select the library TTL.LIB, then 08, 
then 74LS08. 


Notice that the part appears as an AND 
gate. To make the schematic for this 
example, you want the part to appearasa 
NOR with negated inputs. These two 
representations are DeMorgan 
equivalents. 


To get the DeMorgan equivalent, press 
the left button, highlight Convert, and 
press the left button again. Then, place 
the part as you would ordinarily. To get 
the normal symbol back, you would 
repeat the above procedure, but highlight 
Normal instead of Convert. 


The commands along the prompt line should read as 
follows. 


Place Rotate Convert Normal Up Over 
Down Mirror Find Jump Zoom escape 


If you are not at this point in the menu structure, 
review the last two Actions, especially the one that 
describes how to extract the 74LS138. What you want 
to do is extract a 74LS08, but convert it to its DeMorgan 
equivalent before placing it. 


8-16 


Schematic Design Tools Tutorial 


Action: Placing Four More Parts. Move the gate 
to the XY position, 4.80, 3.30. Press the 
left button, highlight Place, and press the 
left button again. 


Place the next part at XY position 4.80, 
3.90. Place the third at 4.80, 4.50 and the 
fourth at 4.80, 5.10. Press the right 
button to return to the main command 
level. 


Although you are at the main command 
level, the main command menu does not 
appear. Press the left button. The main 
command menu now appears. 


Module 1 requires one more part, a 74LS00 for the 
refresh gate. As you've probably already figured out 
from looking at Figure 8-3, the first 74LS138 decodes 
address lines A17 and A18 into the four column address 
strobes, CAS\0 through CAS\1. The second decoder 
produces the corresponding row address strobes. The 
CAS\ signals are asserted during either a memory 
access or a refresh cycle. 


Action: Placing One More Part. From the main 
command menu, select GET. Enter 
74LS00 at the Get? prompt. 


Move the cursor to the XY location 3.00, 
5.60. Press the left button twice. Then, 
press the right button to return to the 
main command level. 


The instructions in this module give exact XY positions 
for the parts that you place. Although unlike real life, 
this makes the construction of the tutorial schematic 
easier. If you place the parts at the designated positions, 
you don't have to move them around as the schematic 
develops. 
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The other options on the Place menu have to do with 
the appearance of the screen symbol and screen 
location. For example, if instead of Convert, you had 
chosen Mirror you would get the part's mirror image. 
Find and Jump quickly move the cursor to a different 
location on the screen. Selecting escape returns you to 
the main command menu. This may also be 
accomplished by pressing the right mouse button. 


The ZOOM command gives you an overview of the 
entire worksheet. It’s the same ZOOM that appears as 
part of the main command menu. This is a good time to 
give it a try. 


Action: Using ZOOM. Press the left button to 
display the main command menu. Select 
ZOOM. The ZOOM menu appears. 
Highlight Select, press the left button, 
highlight 2, and press the left button 
again. You can now see your whole 
worksheet on the screen. 


To return to normal size, press the left 
button, highlight AGAIN, and press the 
left button once more. The ZOOM menu 
reappears. Selecting AGAIN always 
repeats the last item that you selected. 


You can choose Select as before, except 
this time, choose al for normal size. The 
number displayed in parentheses 
indicates the level you will zoom into, and 
1 is where you began. 


So far in this module, you have placed seven parts. One 
of which, was a DeMorgan equivalent. 
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8.3.4. Connecting Wires 


If you look at Figure 8-1, you'll see that what's left to do 
in Module 1 is to connect the parts with wires and fill in 
the title block. To draw wires, use the PLACE 
command, select Wire, and draw the wire with the 
mouse. 


Action: Placing Wires. At the main command 
menu, select PLACE; that is, highlight 
the PLACE command and press the left 
button. Then, select Wire. A command 
list appears on the prompt line. 


Move the cursor until it points to the 
right end of the lead on pin 11 of the 
second 74LS138. This is XY location 4.00, 
4.40. 


Press the left button. Select Begin; that is, 
highlight Begin and press the left button. 

Move the mouse and draw a wire to XY 

location 4.30, 4.40. 


Press the left button twice -- you just 
selected Begin again to change direction. 
Draw a wire straight up to XY location 
4.30, 3.40. Then, select Begin again and 
bring the wire to pin 1 on the top 74LS08. 


Press the left button and select New. 
You're ready to draw another wire. Place 
the cursor at the appropriate position. 
Draw the remaining wires shown in 
Figure 8- 1. 


General Procedure for Drawing Wires. The procedure 
assumes that you selected PLACE from the main 
command menu and then selected Wire. The 
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command list along the prompt line reads as follows: 
Begin End Find Zoom Escape. 


1. Press the left button twice to start drawing. 


2. | When you want to change direction, press the left 
button twice. 


3. | When you want to start a new wire, press the left 
button, highlight New, and press the left button 
again. A new wire is one that’s not connected to 
an existing wire. Selecting New allows you to 
place the start of another wire at a different 
location. It’s like picking up the pen when 
drawing. 


4. When you've finished drawing the last wire, press 
the left button, highlight End, and press the left 
button again. This returns you to the main 
command level. 


A Macro for Placing Wires. Placing wires is a task you 
will perform frequently when drawing schematics. 
Although Module 2 describes how to make a macro, it 
makes sense to include here a short description of a 
macro to place wires. With this macro, one key gets 
you from the main command level to the point where 
moving the cursor draws the wire. 


To define the macro on function key <F2>, perform the 
following steps. 


te From the main command level, select MACRO. 
Then, select Capture. The message <macro> 
appears on the prompt line. 


2. Press function key <F2>. Then, press 
<ENTER>. 


3. Press the keys <P>, <W>, and <B>, for PLACE, 
Wire, and Begin. 
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4, End the macro capture by pressing the <CTRL> 
and <END> keys simultaneously. The message 
<<<MACRO END>>> appears on the prompt 
ine. 


After defining a macro, you can use it during the 
current DRAFT session. To save it for use in future 
DRAFT sessions, you must write the macro out to a file. 
To do that, select MACRO from the main command 
menu; then, select Write. The prompt line displays the 
message, Write all macros to? Respond with the name 
of the file to which you want to write the macro. 


To use the macro, first place the cursor where you 
want to start drawing the wire. Press <F2>. When 
you want to change direction, press <F2> again. When 
you've finished drawing a wire, press the left button 
and select End. 


For additional information on Macros, refer to Section 
4:11. 


NOTE 


When connecting wires end-to-end, take 
care not to overlap them. Overlapping wires 
do not form a connection. The CLEANUP 
utility will repair overlapping wires and 
make them into connections. However, 
CLEANUP will not fix a wire that overlaps 
with the pin on a body object. For example, 
when you connected the wire to pin 11 on 
the 74LS138, you connected a wire to a body 
object pin. 
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Action: Placing More Wires. Refer to Figure 8-1 
and place the remaining wires. 


Place a wire from pin 10 of the lower 
74LS138 to pin 1 of the second 74LS08. 
The wire is vertical along X=4.40. 


Place a wire from pin 8 of the lower 
74LS138 straight across to pin 1 of the 
third 74LS08. 


Place a wire from pin 7 of the lower 
74LS138 to pin 1 of the fourth 74LS08. 
The wire is vertical along X=4.30. 


Place a wire from pin 2 of the first 
74LS08 all the way down to (4.5, 5.8). 
Then, turn left and connect the wire to 
pin 3 on the 74LS00. 


Place a wire from pin 1 of the 74LS00 to 
(T0055. 70). 


Place a wire from 6 of the lower 74LS138 
to (1.00, 4.50). Then place another wire 
from pin 5 to (1.30, 4.70). Then, connect 
pin 4 to pin 1 of the 74LS00. This wire is 
vertical along X=2.50. This is not a true 
connection until you place a junction. 
Placing a junction comes later. 
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Place a wire from pin 2 of the 74LS00 to 
pin 6 of the lower 74LS138. This wire is 
vertical along X=2.3. 


Place a wire from pin 4 of the upper 
74LS138 to pin 5 of the lower 74LS138. 
This wire is vertical along X=1.30. Again, 
this is not a true connection until you 
place a junction. 


Place wires from pins 1, 2, 6, and 5 of the 
upper 74LS128 to X=1.0. 


Place a wire from pin 1 of the upper 
74LS138 at Y=2.60 to pin 1 of the lower 
74LS138. This wire is vertical along 
Kel30. 


Place a wire from pin 2 of the upper 
74LS138 at Y=2.50 to pin 2 of the lower 
74LS138. This wire is vertical along 
they Abb 


Place a short vertical wire on pin 3 of the 
upper 74LS138. It ends at (1.50, 2.80). 


Place wires from pins 15, 14, 18, and 12 of 
the upper 74LS138 to X=3.70. 


Place a wire from pin 3 of the first =| 


74LS08 to (8.50, 4.30). This wire is 
vertical along X=7.80. 
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Place a wire from pin 3 of the second 
74LS08 to (8.50, 4.40). This wire is 
vertical along X=7.70. 


Place a wire from pin 3 of the third 
74LS08 to (8.50, 4.50). This wire is 
vertical along X=7.70. 


Place a wire from pin 3 of the fourth 
74LS08 to (8.50, 4.60). This wire is 
vertical along X=7.80. 


8.3.5 Placing Junctions 


Wires that cross do not represent a connection. To 
make a connection, you must place a junction. A 
junction is unnecessary if the two wires are placed end- 
to-end. For example, you need a junction where the 
wire from pin 4 (G2A) of the lower decoder (the lower 
74LS138) connects to the wire from pin 1 of the NAND 
gate. 


Action: Placing a Junction. From the main 
command menu, select PLACE. From 
the PLACE menu, highlight Junction 
and press the left button. Move the 
mouse to where you want the junction. 
Press the left button twice. You can now 
place another junction by moving the 
mouse to another location and pressing 
the left button twice. When you no longer 
have junctions to place, press the right 
button to escape. 
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You need junctions where the output 
from the 74LS00 connects to the inputs to 
the 74LS08's and where the address lines 
going into the upper decoder connect to 
the wires going to the lower decoder. 


Place junctions at the following locations: 
(1.30, 2.50), (1.20, 2.60), (1.50, 4.70), (2.30, 
4.50), and (2.50, 5.70). 


So far in Module 1, you've connected the parts with 
wires and placed junctions where needed. In Module 2, 
you'll add a bus and labels as well as some more parts. 


8.3.6 Editing the Title Block 


The title block is located in the lower righthand corner 
of the worksheet. You saw it if you zoomed out to look at 
the whole sheet earlier. To get to the title block quickly, 
select the JUMP command from the main command 
menu. Select Reference from the JUMP menu and 
then select A, then 1. Alternatively, you can just move 
the mouse and let the screen pan until the title block 
comes into view. 
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Action: Editing the Title Block. From the main 
command menu, select the EDIT 
command. Make sure that the cursor is 
within the title block. Then, press the left 
mouse button twice. A menu indicating 
the fields in the title block appears. Select 
each field in turn and type the 
appropriate information. 


For example, to enter the Revision code, 
highlight Revision code and press the left 
button. The prompt Revision code?, 
appears on the prompt line. Type in: 01, 
for the revision code followed by 
<ENTER>. 


Notice that the title block does not yet 
show what you typed. 


Now, highlight the next field, Title of 
sheet. Continue through the fields until 
you've entered all the information you 
want to place. You can leave fields blank. 
For example, you have the option of four 
address lines, but Figure 8-1 doesn't show 
any in use. 


When you've completed entering the 
information in the title block, press the 
right button, or the <ESCAPE> key. 
Notice that the information now appears 
on the screen. You are back at the main 
command level. 


8.3.7 Updating the Worksheet 
At this point, you can choose either to QUIT and 


Update the file or QUIT and Write to a file. The 
difference is that update defaults to the currently 
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loaded file. For example, you gave the name. 
TUTOR.SCH when you invoked DRAFT, and the 
Update File command defaults to that name. If you 
choose to write to a file, DRAFT requests the name of 
the file you want to write to. 


Action: Updating the File. From the main 
command menu, select QUIT. Then, 
select Update file. Press the right button 
to return to the main command level. 


8.3.8 Making a Hardcopy 


The final action in Module 1 is to print out a copy of the 
worksheet. 


Action: Making a Hardcopy. From the main 
command menu, select HARDCOPY. 
The HARDCOPY subcommand menu 
appears. Now, select the appropriate 
paper width using the HARDCOPY 
Width of Paper command. 


Finally, check and make sure that your 
printer has power and is online. Then, 
select Make Hardcopy. 


Output resolution depends on which printer driver you 
have configured. For example, there are four HP 
LaserJet printer drivers available with OrCAD/SDT III 
(75, 100, 150, and 300 dpi). If you have the 150 dpi 
driver configured, then the output resolution is 150 dots 
per inch. 


For additional information, refer to the HARDCOPY 
command outlined in Section 4, the PRINTALL utility 
in Section 6, and Section 2.4 for configuration 
information. 
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8.3.9 Exiting DRAFT 
Time for a break? You bet! 


Action: Exiting DRAFT. From the main 
command menu, select QUIT. Then, 
select Abandon Edits. The DOS prompt 
appears. 


This is the end of Module 1. Module 2 completes the 
schematic that we began in Module 1. Module 3 gives 
examples of using the OrCAD utilities. 


8.4 MODULE 2: CONSTRUCTING A 
WORKSHEET, PART 2 


Summary: This module completes the drawing of the 
sample schematic. It includes creating and placing a 
custom part, defining a macro, adding input and output 
module ports, placing a bus, and placing power symbols. 


Module 1 required one part library, TTL.LIB. Module 
2 requires two additional libraries: DEVICE.LIB, and a 
custom library. Figure 8-2 shows the worksheet at the 
conclusion of Module 2. 
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8.4.1. Creating the Custom Library 


Module 2 requires the use of a time-delay chip that is 
not in the OrCAD-supplied libraries. You must create a 
custom library that contains the part definition. With 
OrCAD/SDT III, there are a couple of ways to create 
library parts. One method, uses the graphical object 
editor called LIBEDIT, in which parts are created on 
the screen. The other method, uses a text file to describe 
the part and other utilities to convert the source to an 
object file. Since, Section 7 outlines the procedure for 
using LIBEDIT, we will use the second method to 
create the custom part required in this module. 


To do that, we will: 1) create a library source file, 2) run 
COMPOSER on that source file to create a library file, 
and 3) reconfigure DRAFT to use the custom library. 
For additional library information, refer to Section 7. 


To create the source file, use a text editor that makes a 
pure ASCII file with no embedded control characters. 
This is the same kind of text editor, you would use to 
create program source files. For example, either 
Wordstar in the non-document mode or EDLIN 
satisfies this requirement. 


Action: Creating a Custom Library. Use a text 
editor to create the following text file. 
Call the file TUTOR.SRC and place it in 
the library directory. Enter the following 
text in the file. 
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PREFIX 

END 

"time delay' 

64 1 

Viyth ak IN 2 ING 

Bieeere OUT aie ly 
Ww BSITLO OUT oe 

BSti.g OUT eg ogc 

BUr ai? PWR ‘GND ' 

TO °c 14 PWR eC. 


Then, invoke the OrCAD utility 
COMPOSER as follows. This assumes 
that you are presently in the LIBRARY 
subdirectory and that COMPOSER.EXE 
is also in this directory. At the DOS 
prompt, type: 


C:\ORCAD\LIBRARY>COMPOSER 
TUTOR.SRC TUTOR.LIB <ENTER> 


Then, invoke DRAFT with the /C option 
and add the newly created library 
TUTOR.LIB. Ensure that all of the 
required libraries are configured. 


8.4.2. Invoking DRAFT and Setting a Macro 


Action: Invoking DRAFT. Invoke DRAFT and 
specify the file TUTOR.SCH that you 
created in Module 1. Enter the following: 


C:\ORCAD>DRAFT TUTOR.SCH 


Notice that when DRAFT comes up, the grid dots are 
not visible; nor are the XY coordinates shown in the 
upper right corner. To set the environment as in 
Module 1, you must once again issue the SET 
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command. However, if the Module 1 environment is 
one you plan to use frequently, it's convenient to define 
amacro. The action below defines the function key 
<F1> as a macro that makes the grid dots visible and 
starts up the XY display. 


Action: Defining a Macro. Press the left button to 
display the main command menu. Select 
Macro; that is, highlight Macro and press 
the left button. Then, select Capture. 


The message, "Capture macro?” appears 
on the prompt line. Press the <F1> 
function key. The characters Fl appear 
on the prompt line. Then, press 
<ENTER>. The message <macro> 
appears on the prompt line. This begins 
the macro definition. 


Press <s>. The SET menu appears. 
Then, press <g>. The grid parameters 
menu appears. Press <v>, then <y>. 
You are now back at the main command 
level. 


Press <s>. The SET menu reappears. 
Press <x>, then <y>. You are now at the 
main command level. Press <m> to end 
the macro definition. 


Note that in Module 1 you defined a macro on F2 and 
ended the macro capture with CTRL-END, rather 
than <m>. If you end a macro capture in the middle of 
a command sequence, as in Module 1, you must use 
CTRL-END. At the main command level, either 
CTRL-END or <m> work. The macro defined above 
would accept either CTRL-END or <m>. The macro 
in Module 1 required CTRL-END. 
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Macros are usable right after you define them. But to 


use macros in future sessions, you must save them to a 
file. 


Action: Saving Macros. From the main 
command level, press the left button. 
This displays the main command menu. 
Select Macro. Then, select Write. The 
prompt, "Write all macros to?” appears. 
Type the name of what will be your 
macro file (for example, SCOTTY.MAC) 
and follow it with an <ENTER>. 


The macro file is a-text file. You can view it with the 
DOS type command. The macro definition for <F1> 
looks as follows: {F1}=sgvysxy{}. You could have 
created the macro file with a text editor, and it would 
work just as well. 


If you want the macro file to be loaded automatically 
every time you invoke DRAFT, you must reconfigure 
DRAFT and specify the macro file. Loading the macro 
file automatically does not mean executing the 
contained macros. It means making them available for 
use. 


You can load the macro file manually. To do that, select 
MACRO from the main command menu. Then, select 
Read and give the filename of the macro file. If you 
give just a filename, DRAFT assumes the macro file is 
in the same directory as DRAFT.EXE. Alternatively, 
you can specify a complete pathname. 


8.4.3 Placing Module Ports 
All signals that go from one worksheet to another 


require module ports. Signals that remain internal to 
the worksheet may require to be labeled with Labels, 
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depending on the design. For example, all buses require 
a Label to be placed on it. 


The worksheet from Module 1 has a number of 
unlabeled inputs and outputs. The next Action describes 
how to place the input module ports. 


Action: Placing Module Ports. From the main 
command level, press the left button. The 
main command menu appears. Select 
PLACE. Then, select Module Port. The 
prompt line reads Module Port Name? 


Type the name of the first module port. 

In this case, it's A18. Follow it with an 
<ENTER>. Another menu appears, 
identifying the type of module port. Select 
Input. 


The module port appears on the screen. 
Move it so that its right tip touches the 
input line to pin 1 on the first decoder. 
Press the left button twice to place the 
module port. 


Once again, the prompt line reads, 
Module Port Name? Continue the above 
procedure and place all the input module 
ports. They are as follows. 


Input Module Port Name XY Location 
Al7 (0'; 6072560) 
DACKOBRD\ (COS1O0;, 73:30 0) 
CAS\ (O90 7. 352) 
RAS (O60) ~ 4250) 
RAM ADDR SEL (ORZO;, F4747,0)) 
DACK 0 CO. 2G Ah cSia.t O) 


This concludes the input module ports. Placing an 
output module port is similar. Just select Output 
instead of Input after you type the module port name. 
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Place four output module ports at the following 
locations: 


Output Module Port Name XY Location 


RASO\ (3.50, 42380) 
RAS1\ Uso pe 4.40) 
RAS2\ (8.00, 4.50) 
RAS3 \ (8.50, 4.60) 


Press the right button and return to the main 
command level. 


8.4.4 Placing a Bus 


Placing a bus is similar to placing a wire. A bus appears 
on the screen as a thick wire. In our schematic, the 
column address strobe lines from the top decoder are 
drawn as a bus. 


Action: Placing a Bus. From the main command 
menu, select PLACE. Then, select bus. 
Put the cursor where you want the bus to 
begin (3.80, 2.60) and press the left button 
twice. Move the cursor to 8.10, 2.90. 
Press the left button, highlight End, and 
press the left button again. Next, place 
the output module port, CAS\[0..3] at the 
end of the bus. 
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Action: Placing Bus Entries. From the main 
command menu, select PLACE. Then, 
select Bus (entry). A slash appears at the 
cursor tip. 


For this particular schematic, you want a 
backslash rather than a slash. (This 
decision is cosmetic only.) Press the left 
button, highlight the \, and press the left 
button again. Move the cursor so that the 
backslash connects the wire from pin 15 
to the top decoder to the top of the bus. 
Press the left button twice. Now, press 
the <ESCAPE> key. Next, we will use 
the REPEAT command to place the other 
three Bus (entries). Press, <r> three 
times. Notice, that the remaining entries 
are automatically placed. 


8.4.5 Label and Module Port Conventions 


In a design, a label must be placed on every bus that is 
used in a worksheet. This informs the NETLIST utility 
program how many members are associated with a 
bus. Labels are placed in a worksheet with the PLACE 
Label command. 


Bus labels must be in the form: 
BUSNAMEI(O0..n] 


Where BUSNAME is called the "prefix" and represents 
the name of the bus. [0..n] is called the "suffix", where n 
represents the decimal number of the last member of 
the bus; only a zero (0) is valid in the first portion of the 
suffix ((2..n] for example, is not valid. Between the 
prefix and the suffix there must be no space. 
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Labels must also be used to label the individual 
members, or signals, that come from a bus. As a rule, 
you may place any number of labels on a bus signal. 
When labels are placed on signals that come from a bus, 
they must be labeled in a form that corresponds to the 
bus they come from. This form is: 


BUSNAMEx 


Where BUSNAME is the same prefix name as the bus 
label, x is a decimal number in the range of [0 - n] taken 
from the suffix of the bus label, and n represents the 
decimal number of the last member of the bus. 
Between BUSNAME and x there must be no space. 


As mentioned, any signal that leaves the worksheet 
must do so via a module port. A module port may have 
any name when it is connected to a wire, a suffix is not 
required. However, when connected to a bus, a module 
port must have the same suffix as the label placed on 
the bus that it connects to. The proper form is: 


BUSNAME[0..n] 


Where BUSNAME is called the "prefix" and it 
represents the name of the bus. [0..n] is called the 
“suffix”, where n represents the decimal number of the 
last member of the bus. As mentioned, when connected 
to a bus, module port suffix names must match the label 
suffix name that is placed on the bus. The prefix, can be 
named anything. But is good practice to make the 
entire module port name, match the label placed on a 
bus. Between the prefix and the suffix there must be no 
space. 


8.4.6 Placing Labels 


Now that we know the conventions of proper labeling, 
it's time to go ahead and place them. 
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Action: Placing Labels on Bus Signals. From the 
main command menu, select PLACE. 
Then, select Label. The prompt, Label? 
appears on the prompt line. Type the 
label, CAS\O, followed by an <ENTER>. 


Move the label until it rests on the wire 
output from pin 15 of the top decoder. 
This is XY location (3.70, 2.50). Press the 
left mouse button twice to place it. The 
prompt, Label? reappears. Press the 
<ESCAPE> key to return to the main 
command menu level. To place the 
remaining three labels we will use the 
REPEAT command. Now, press <r> 
three times. Notice that the remaining 
three label names were numerically 
incremented and placed in the 
worksheet. 


Action: Placing a Label on a Bus. From the main 
command menu, select PLACE. Then, 
select Label. The prompt, Label? appears 
on the prompt line. Type the label, 
CAS\(0..3], followed by an <ENTER>. 


Move the cursor and place the label on 
the bus. A good location is (4.30, 2.90). 


8.4.7 Placing Power Objects 


The lower decoder takes +5V on pin 3; the upper 
decoder has its pin 3 grounded. Both the ground symbol 
and the +5V symbol are power objects, even though the 
ground symbol comes from a library (DEVICE.LIB) 
and the +5V comes from the PLACE menu. 
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Action: Placing Power Objects. From the main 
command menu, select PLACE. Then, 
select Power. A list of commands appears 
on the prompt line. 


The power symbol appears on the screen, 
and it moves with the cursor. The default 
value is VCC. To change the value, press 
the left button and select Value. 
Backspace over the VCC and type +5V 
followed by an <ENTER>. 


Then, press the left button and select 
Orientation. Then, select Bottom. Now 
move the cursor to pin 3 on the lower 
decoder and press the left button twice. 
The other power symbol is a ground 
symbol belonging to DEVICE.LIB. It is 
called GND POWER. Obtain this part in 
the same way you obtained the decoders 
and gates in Module 1. Place it at pin 3 of 
the upper decoder. 


Note that the devices placed on the worksheet do not 
show any power pins. However, the part definitions do 
define power pins, and power pins will appear in the 
netlist (see Module 3). The invisible power pins are 
defined in the library part as VCC and GND. 


In our example, we want to have all VCC and +5V 
supplies connected to the same potential. If you place a 
power object with value +5V and it is not connected to a 
VCC power object, the NETLIST utility will assume 
two separate power supplies, one called +5V and one 
called VCC. In this case, we want them connected. 
Therefore, we will place together in the worksheet. 
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Action: Connecting Power Objects. Place 
another power object with value VCC at 
(7.40, 0.70). Also, place a power object 
with value +5V at (7.90, 0.70). Connect 
them to each other with a wire. 


8.4.8 A Complete Circuit 
Now is a good time to update the work file with the 
Update command in the QUIT menu. Figure 8-3 


shows how your worksheet looks so far. You can print 
it out with the HARDCOPY command. 
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Figure 8-3 Current State of the Worksheet 
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8.4.9 Placing More Parts 


What remains to be done in Module 2 is to add a portion 
of the circuit that delivers the RAS and CAS\ signals. 
These derive from the XMEMW\ and XMEMR\ 
signals (not yet shown). This involves placing three 
more parts on the worksheet. | 


Action: 


Action: 


Action: 
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Placing Three More Parts. Place a 
74LS00 at (6.50, 1.60). Place its 
DeMorgan equivalent at (3.00, 0.90). 
Then, place the custom part Time Delay 
from TUTOR.LIB at (4.80, 1.00). 


Drawing More Wires. Draw two wires, 
one beginning at (1.00, 1.00) and 
connecting to the leftmost 74LS00's top 
input pin. Draw the other wire from 
(1.00, 1.20), connecting to the leftmost 
74LS00's bottom input pin. 


Connect the output of the leftmost 
74LS00 to pin 1 on the time delay chip. 
Then, connect pins 8 and 12 to the inputs 
on the second 74LS00. 


Finally, bring a wire from pin 10 of the 
time delay chip to the right end of the 
worksheet, vertically even with the end of 
the bus. 


Placing Module Ports. Place three 
module ports. XMEMW\ and 
XMEMR\ are input to the first 74LS00, 
and ADDR SEL is output from the time 
delay chip. 
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8.4.10 Editing the Worksheet 


First of all, you must delete the RAS and CAS\ lines 
going into the decoders. These signals are no longer 
input module ports. 


Action: Deleting the RAS Line. Put the cursor on 
the RAS line, around (1.80, 4.50). From 
the main command menu, select 
DELETE. Then, from the DELETE 
menu, select Object. Now press the left 
button twice. The wire is deleted up to the 
junction. : 


Put the cursor on the RAS input module 
port and press the left button twice. The 
module port is now deleted. 


The signal RAS comes from the output of the first 
74LS00 and goes to pin 6 of the lower decoder. You 
need to place a junction between the first 74LS00 and 
the time delay chip. 


Action: Placing a Junction. Move the cursor to 
the wire that goes from the output of the 
first 74LS00 to the input of the time delay 
chip. (4.10, 1.10) is a reasonable location. 
Place a junction. Then, draw a wire 
down to (4.10, 3.60). Then, turn left and 
draw a wire to (2.30, 3.60). This lines up 
with the junction remaining from the 
RAS input you deleted earlier. Draw a 
wire down to that junction. This is the 
RAS line. 


So far in this tutorial, Left Button has been set to NO. If 
you've performed the designated Actions, you now have 
a pretty good feeling about how the mouse buttons 
operate. Try setting Left Button to YES, and observe 
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that the user interface to the commands is somewhat 
different. 


Action: Setting Left Button to YES. From the 
main command menu, select SET. Then, 
select Left Button, followed by Yes. 


Now delete the CAS\ input to the upper 
decoder. The new CAS\ line will come 
from the output of the second 74LS00. 


Action: Deleting the CAS\ Line. Move the cursor 
to the CAS\ input of the top decoder at 
(1.10, 3.20). From the main command 
menu, select DELETE. Then, highlight 
Object and press the left button twice. 
The wire is now deleted. 


Put the cursor over the CAS\ module 
port. Press the left button. The module 
port is now deleted. 


From the main command menu, select 
PLACE, then Wire. Place the cursor at 
pin 5 of the second decoder at (1.50, 3.20). 
Press the left button and begin drawing in 
the left direction until (1.10, 3.20). Then, 
press the left button and go up until (1.10, 
2.20). Press the left button and go right 
until (7.40, 2.20). Press the left button 
and go up to the output of the NAND gate 
(7.40, 1.80). Press the left button and hold 
it down. Move the highlight to End and 
raise the left button. 


Notice that drawing lines with Left Button set to YES 
reduces the number of button presses you must 
perform. It associates one of the button presses with a 
button release. 


8-44 


Schematic Design Tools Tutorial 


The schematic is now complete, except for two labels. 
The final step is to label the RAS and CAS\ lines. 


Action: Placing More Labels. From the main 
command menu, select PLACE, then 
Label. At the prompt Label? type CAS\, 
followed by an <ENTER>. Move the 
label to (7.40, 2.00) and place it. 


The prompt Label? appears again. Type 
RAS, followed by an <ENTER>. Move 
the label to (4.10, 1.90) and place it. Then, 
press the right button to return to the 
main command level. 


Be sure to update your work file. The 
Update command is under the QUIT 
menu. You may also wish to make a 
hardcopy of your design. Then, exit 
DRAFT by choosing Abandon edits from 
the QUIT menu. 


Action: Exiting DRAFT. Update the work file. If 
you want a hardcopy, go ahead at this 
time and print one. Then, exit DRAFT. 


8.5 Module 3: Using the OrCAD Utilities 


Summary: This module shows how to run all the 
appropriate OrCAD utilities on the work file created in 
the two previous modules. 


The work file constructed in Modules 1 and 2 is a one- 
sheet schematic. Those utilities that deal with 
hierarchical structures or flat file structures are 
discussed only briefly in this module. When you invoke 
one of the OrCAD utilities on a one-sheet schematic, 
append the switch /o (oh) to the command line. 
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The OrCAD utilities are as follows. 


ANNOTATE This utility scans an input file and 
automatically updates reference designators. This 
includes updating the corresponding pin numbers that 
are associated with a particular instance of a device 
with multiple parts per package. ANNOTATE 
modifies your work file; but it creates a backup file that 
contains the original copy of the work file. 


BACKANNO Use this utility when you want to update 
the reference designators after you've run 
ANNOTATE. For example, assume that you sent your 
design out for layout; and when it comes back, what you 
had designated as U1A is now U1B. You can run 
BACKANNO and supply as input your initial work file 
and a was/is text file that contains the new translation. 


CLEANUP This utility scans a work file and checks 
for overlapping parts. It removes duplicate or 
overlapping wires, buses, and junctions. It displays 
warning messages advising you of duplicate objects. 
CLEANUP may modify your work file; but it creates a 
backup file that contains the original copy of your work 
file. 


CLEANUP does not check for objects overlapping part 
leads and wires overlapping buses (including wire 
entries of a bus overlapping bus entries to a bus). 


ERC This utility performs a classical electrical rules 
check. It flags unused inputs on parts, unlabeled wires 
connected to a bus, and invalid connections, such as two 
outputs wired together. 


NETLIST This utility generates a net and wire list ina 


number of possible formats. The default format is 
EDIF. 
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PARTLIST This utility creates a list of the parts in 
your work file. If you have additional information that 


you want included in that list, you can construct an 
Include file. 


PRINTALL, PLOTALL These utilities are not 
discussed in this tutorial. They are used for printing 
and plotting schematics. 


TREELIST This utility is not discussed in this tutorial. 
It scans a hierarchical structure and displays the sheet 
names, sheet pathnames, and optionally the date of last 
modification. 


8.5.1 ANNOTATE 


ANNOTATE is probably the first utility you should run. 
Other utilities report information about your work file, 
and, if you run ANNOTATE first, you ensure that the 
information is reported in terms of the updated 
reference designators. 


With ANNOTATE, you can chose to have the updated 
information merged with the workfile or placed in an 
annotation file. The purpose of an annotation file is to 
store the reference designators of a complex hierarchy. 
The example in this tutorial is a one-sheet schematic 
and has no need of an annotation file. 


To ran ANNOTATE on the work file TUTOR.SCH, 
type the following. 


C:\ORCAD>ANNOTATE TUTOR.SCH /M /O 


This example assumes that TUTOR.SCH is in the sheet 
directory. The /M tells annotate to merge the updated 
information into the work file. If you left the /M out, 
ANNOTATE would abort. Without a /M, ANNOTATE 
expects two filenames. The first is the source file; the 
second is the name of what will be the annotation file. 
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Figure 8-4 shows how the worksheet looks after 
running ANNOTATE. Notice the updated reference 
designators on the devices with multiple parts per 
package. For example the U?A on the 74LS00s 
connected to the output of the lower decoder changed to 
U1A, U1B, U1C, and U1D. They are all parts of the 
same package, and their pin numbers changed 
accordingly. 


NOTE 


This assumes that the objects placed in the 
TUTOR.SCH schematic, were placed in the 
order described in this tutorial. If they were 
not, the schematic may not be annotated in 
the order illustrated in Figure 8-4. 
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Figure 8-4 The Worksheet after Running ANNOTATE 
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8.5.2 BACKANNO 


Assume that, in Figure 8-4, you really wanted U2B to 
be designated as U2A. You also wanted U2C to be U2B 
and U2A to be U2C. You may find that your board lays 
out better with a pin rearrangement on the 74LS00 
designated as U2. 


You can construct a was/is file and use the 
BACKANNO utility. A was/is file is a text file that lists 
the old reference designator followed by what you want 
the designator to be. For example, here is a was/is file 
that redefines the U2 74LS00. 


UZBVIU2AN M2CI Wigs 2A 2c 


When BACKANNO changes the reference designators 
it updates the pin numbers correspondingly. To run 
BACKANNO on the file TUTOR.SCH, type the 
following. 


C:\ORCAD>BACKANNO TUTOR.SCH WASIS 
/O 


This example assumes that TUTOR.SCH is in the sheet 
directory and that the wasis file is in the DRAFT 
directory. 


8.5.3 CLEANUP 


Typically, CLEANUP is the second utility you run. 
CLEANUP corrects simple drawing errors that may 
inadvertently show up as errors in ERC's electrical 
rules check. Note that CLEANUP will not fix up wires 
that overlap body object pins. To ran CLEANUP on the 
work file TUTOR.SCH, type the following. 


C:\ORCAD>CLEANUP TUTOR.SCH /O 
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This example assumes that TUTOR.SCH is in the sheet 
directory. | 


8.5.4 ERC 


This utility performs a basic electrical rules test. To run 
ERC_.on the work file TUTOR.SCH, type the following. 


~ C:\ORCADSERC TUTOR.SCH TUTOR.ERR 
/O/U 


This example assumes that TUTOR.SCH is in the sheet 
directory. The second filename is for a file that will 
contain messages from ERC. It is created in the 
DRAFT directory. If you omit the second filename, 
these messages display on the console. The /U switch 
generates a unconnected pin report. ERC lets you know 
that it is working by displaying a sequence of asterisks 
(*) and periods (.). 


After the ERC utility is completed, you can examine the 
resultant TUTOR.ERR error file with a text editor. 
The contents are as follows: 


LAL 2 Cl 

UNCONNECTED REPORT X= 2.80 Y= 2.90 
OUCpUGUsy wal Xe T2800 Y= 3 00 
Oubpoeus/ VS. Xeee 2804 Ya - re. 10 
Outputuspeo: eX= 2780 Wa es 520 
Outpucus,; 27 om 4.00 Ys" 4°00 
OutputU4,YO X= 4.00 Y= 4.10 
Oubpatudy yi k= "4°00" (Ye *4.20 
OutputU4,Y2 X= 4.00 Y= 4.30 


OutputU4, Y3 


WARNING - POWER Supplies are 
CONNECTED VCC <-> +5V 


The unconnected report states that many pins are 
unconnected. By examining our schematic, these pins 
were intentionally left unconnected. Therefore, this 
information can be ignored. 
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A typical test is to ensure that all inputs to a device are 
connected. For example, if you neglected to connect pin 
3 of the upper decoder to ground, you get the following 
message. 


WARNING - INPUT has NO Driving Source 
U3,C 


Also, you must label every bus. For example, if in 
TUTOR.SCH, you did not include the bus label 
CAS\(0..3], ERC would display the following message. 


<<<WARNING>>> Unconnected MODULE 
PORT "CAS\(0..3]" at X =8.10 at Y= 2.90 


By connecting the two power objects, VCC and +5V, 
together, you generate the following warning. 


WARNING - POWER Supplies are 
CONNECTED VCC <-> +5V 


This is something you intended. You can safely ignore 
the warning. 


8.5.5 NETLIST 


The NETLIST utility generates a netlist in a variety of 
formats, the default of which is EDIF. 


To create a proper net list, you need to show care when 
dealing with bus labels, module ports, and power objects. 
Refer to Section 6 for a detailed explanation of these 
requirements. Outlined below, is a list of some general 
guidelines. 


1. Thoroughly read the discussion on the NETLIST 
utility locatedin Section 6. 
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2. Place Labels in the correct format on all buses 
(refer to previous discussions and the NETLIST 
utility in Section 6). 


3. Place Labels in the correct format on all signals 
that connect to a bus (refer to previous 
discussions and the NETLIST utility in Section 
6). 


4. Place module ports in the correct format, on all 
signals that go off the worksheet (refer to 
previous discussions and the NETLIST utility in 
Section 6). 


5. Do not put a blank space in any label or between 
the prefix and suffix in a module port name. 


6. Do not overlap wires or buses with other wires, 
buses, or object pins. 


To run NETLIST on the work file TUTOR.SCH and 
generate a file in CALAY format, type the following. 


C:\ORCAD>NETLIST TUTOR.SCH 
TUTOR.NET CALAY /S /O 


This example assumes that TUTOR.SCH is in the sheet 
directory. The second filename, TUTOR.NET is for a 
file that will contain the netlist information. This file is 
created in the DRAFT directory. If you omit the second 
filename, the net list displays on the console. 


The /s generates a special net list format other than 
EDIF. Calay signifies the special netlist format. Note 
that when you choose CALAY format, NETLIST 
creates two files. One file contains the CALAY netlist; 
this is the file TUTOR.NET specified on the command 
line. The other file is the component file generated by 
NETLIST with an extension of .CMP. 
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NETLIST lets you know that it is working by 
displaying a sequence of asterisks (*) and periods (.). 
The file containing the CALAY netlist is as follows. 


/NO0001 
/NO0002 
/NO00003 
/NO00004 
/NO0005 
/NO0006 
/NO0007 
/N00008 
/NO0009 
/N00010 
/NO0011 
/NO00012 
/N00013 
/NO00014 
/GND 

/NO0016 
/N00017 
/NO00018 
/N00019 
{VCE 

/NO0021 
/N00022 
/N00023 
/NO0024 
/N00025 
/NO00026 
/N00027 
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The component file NET.CMP is as follows. 


74LS00 U2 shape =X ei 0 
74LS08 U1 shape -X=- =Y— 0 
74LS138 U3 shape wa some tt Se 0 
74LS138 U4 shape =X sod Sp 0 
TIME DELAY U5 shape “x= ie 0 


8.5.6 PARTLIST 


This utility creates a list of all the parts used in the 
worksheet. You can specify an Include file if you want 
that list to contain additional information. To run 
PARTLIST on TUTOR.SCH without an Include file, 
type the following. 
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C:\ORCAD>PARTLIST TUTOR.SCH 
TUTOR.1ST /O 


This example assumes that TUTOR.SCH is in the sheet 
directory. The second filename, TUTOR.1ST, is the 
name of a file that will contain the part list. This file is 
created in the DRAFT directory. If you leave out the 
second filename, the part list displays on the console. 
The part list that results from TUTOR.SCH follows. 


Memory Decode, Module 2 of Tutorial Revised: 
November 16, 1986 


a Lokal 
Revision: 
Bill Of Materials November 16, 1986 
22218208 Page zi 
Item Quantity Reference Part 
1 1 Wil 74LS08 
2 1 U2 74LS00 
3 2 Us ue 74LS138 
4 di U5 TIME DELAY 


An include file is a text file that contains information 
you want to add to the part list. It consists of a series of 
columns with a header. 


The header begins with a pair of single quotes with no 
character between them. The remainder of the header 
consists of the titles for the additional columns. These 
titles will be added to the header information in the part 
list. 


The rows underneath the header consist of part- 
specific information. The first row identifies the part, 
and the subsequent rows depend on the associated 
header. An Include file for TUTOR.SCH follows. 


ae DESCRIPTION Part Order Code 
'74LS00' TTL Quad Two Input NAND Gate 10003040000 
'74LS08' TTL Quad Two Input AND Gate 10003050000 
'74LS138' TTL Decoder/Demultiplexer 10005120000 
'TIME DELAY ‘Gate Delay 25/125 10006400000 
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To specify this Include file when you invoke 
PARTLIST, type the following. 


C:\ORCAD>PARTLIST TUTOR.SCH 
TUTOR.1ST TUT.INC /I/O 


Note that TUTOR.SCH is in the sheet directory and 
that TUTOR.1ST is generated by PARTLIST and is 
placed in the ORCAD directory. Finally, the include file 
TUT.INC should be placed in the ORCAD directory. 


The resulting part list now looks as follows. 


Memory Decode, Module 2 of Tutorial Revised: November 16, 1986 11111 


Revision: Bill Of Materials November 16, 1986 22:18:28 Page 1 
Item Qty Ref Part DESCRIPTION Part Order Code 

1 1 U2 74LS00 TTL Quad Two Input NAND Gate 10003040000 

2 1 Ul 74LS08 TTL Quad Two Input AND Gate 10003050000 

3 2 U3,U4 74LS138 TTL Decoder/Demultiplexer 10003060000 

- it US TIME DELAY Gate Delay 25/125 10006400000 


8.5.7 PRINTALL, PLOTALL 


These utilities permit the printing or plotting of files in 
batch mode. 


With the PRINTALL utility, you can print the 
schematic file without invoking DRAFT. For example, 
to print the file TUTOR.SCH, type the following. 


C:\ORCAD>PRINTALL TUTOR.SCH /O 


The PRINTALL utility is most useful for hierarchical 
structures and flat file structures. For example, 
TUTOR.SCH is a one-sheet schematic that could be a 
member of a flat file structure. A flat file structure is a 
text file containing the names of a number of one-sheet 
schematics. You can print the entire collection by 
invoking PRINTALL and specifying the flat file 
filename. 


8-56 


Schematic Design Tools Tutorial 


The PLOTALL utility is similar to PRINTALL, but is 
specific to plotters. Note that DRAFT'’s Hardcopy 
command works with printers, not plotters. To plot a 
schematic file, refer to the description of the PLOTALL 
utility in Section 6. 


8.6 CONCLUSION 


This is the end of the tutorial for OrCAD/SDT III. As an 
introductory tutorial, it was not intended as a complete 
description of the OrCAD/SDT III environment. The 
tutorial covered the basics of creating a one-sheet 
schematic and using the OrCAD utilities. The 
OrCAD/SDT III environment is rich and varied, and 
you will discover many additional features as you build 
your design. 


For example, the tutorial has only scratched the 
surface of macro building and has hardly mentioned 
hierarchical structures. The Drag command provides 
additional editing capability. With the Fixup 
command, you can make the wires rubberbanded with 
Drag orthogonal again. 


Examples of other features include the ability to 
improve cursor movement by setting tags on your 
worksheet and to speed up the repetitive placement of 
objects with the REPEAT command. 


Consult the other sections in this manual for additional 
information. 
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APPENDIX A 


SUMMARY OF LIBRARY COMPONENTS 


Directory of ANALOG.LIB 


1458 1558 7621 ADC0801 

ADC0802 ADC0803 ADC0804 ADC0805 

ADC0808 ADC0809 DAC0800 DACO801 

DAC0802 DAC0806 DAC0807 DAC0808 

DAC8408 LF13741H LF13741N LF147D 

LF147N LF155H LF156H LF157H 

LF255H LF256H LF257H LF347D 

LF347N LF351H LF351N LF353H 

LF353N LF355H LF355N LF356H 

LF356N LF357H LF357N LF411H 

LF411N LF412H LF412N LF441H 

LF441N LF442H LF442N LF444D 

LF444N LHO0002N LHO003H LHO004H 

LM101H LM101J9 LM101914 LM102H 

LM107H LM107J3 LM107314 LM108H 

LM108J LM108J8 LM10H LM10N 

LM11D LM11H LM11N LM124 

LM13080N LM13080P LM1458H LM1458J9 

LM1458N LM146J LM148J LM149 

LM1558H LM1558J7 LM158H LM159J 

LM192H LM192J LM201H LM2017 

LM201914 LM202H LM207H LM207J3 

LM207314 LM208H LM2087 LM208J8 

LM216H LM224 LM246J LM246N 

LM2 48 LM248J LM258H LM29007 

LM2900N LM2904N LM2924g LM2924N 

LM292H LM2 927 LM301H LM3017 

LM301914 LM301N LM302H LM307H 

LM3077 LM307J14 LM307N LM308H 

LM308J9 LM308J8 LM316H LM324 

LM3301N LM339 LM3401N LM3 467 

LM346N LM348 LM3 483 LM348N 

LM349N LM358H LM358N LM359J 

LM359N LM3900N LM392H LM392J 

LM392N LM4250H LM42507 LM555 

LM709H LM709N LM709N8 LM725H 

LM725N LM741 LM741H LM741J14 > 
LM741N LM741N14 LM747 LM747H v 
LM7473 LM7 48H LM748J LM748N Bl 
LM7805 LM7806 LM7808 LM7810 = 
LM7812 LM7815 LM7818 LM7 824 o 
LM7885 MC1455 MC1555 MC1741 Le 
NES555 OPAMP TLO72 TLO82 no 
TLO92 UA741 VOLTAGE REGULATOR 
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Directory of ASSEMBLY.LIB 


08 PIN 14 PIN 16 PIN 24 PIN 

28 PIN 40 PIN BOTTOM 40 PIN TOP CAP 2X7 

EDGE CONNECTOR RESISTOR 1X2 RESISTOR 1X3 RESISTOR 1X5 
RESISTOR PACK TO 220 TOeS9 BOnIZ 

XTAL 


Directory of CMOS.LIB 


4000 4001 4002 4006 4007 4008 4009 4010 4011 
4012 4013 4014 4015 4016 4017 4018 4019 4020 
4021 4022 4023 4024 4025 4026 4027 4028 4029 
4030 4031 4032 4033 4034 4035 4037 4038 4040 
4041 4042 4043 4044 4045 4046 4047 4048 4049 
4050 4051 4052 4053 4054 4055 4056 4057 4059 
4060 4063 4066 4068 4069 4070 4071 4072 4073 
4075 4076 4077 4078 4081 4082 4085 4086 4089 
4093 4094 4095 4096 4098 4099 4501 4502 4503 
4504 4505 4506 4508 4510 4511 4512 4513 4514 
4515 4516 4517 4518 4519 4520 4521 4522 4524 
4526 4527 4528 4529 4530 4531 4532 4534 4536 
4537 4538 4539 4541 4543 4544 4547 4549 4551 
4552 4553 4554 4555 4556 4557 4558 4559 4560 
4561 4562 4566 4568 4569 4572 4573 4574 4575 
4580 4581 4582 4583 4584 4585 4597 4598 4599 
5101 14000 14001 14002 14006 14007 14008 14011 14012 
14013 14014 14015 14016 14017 14018 14020 14021 14022 
14023 14024 14025 14027 14028 14029 14032 14034 14035 
14038 14040 14042 14043 14044 14046 14051 14052 14053 
14066 14068 14069 14070 14071 14072 14073 14075 14076 
14077 14078 14081 14082 14093 14094 14099 14160 14161 
14162 14163 14174 14175 14194 14501 14502 14503 14504 
145055214506 T4508 pel4510 91451 teaasa2 14513) asia 14505 
14516...14517 14518 14519 14520;14521 14522 145241114526 
145272414528 1452954530 14531 yaess2 14534 8145366014537 
14538 14539 14541 14543 14544 14547 14549 14551 14552 
145537424554 14555, 744556 1455 76p 2558 14559 I4S60N14561 
14562 14566 14568 14569 14572 14573 14574 14575 14580 
14581 14582 14583 14584 14585 14597 14598 14599 40100 
40101 40102 40103 40104 40105 40106 40115 40116 40160 
40161 40162 40163 40174 40175 40182 40192 40193 40194 
42100 45100 45101 45104 45106 45107 45109 45112 145104 
145106 145107 145109 145112 
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Directory of DEVICE.LIB 


12 HEADER 
1RSW3 

2RSW3 

ANTENNA 

BRIDGE 
CAPACITOR 
CAPACITOR VAR 
CONNECTOR COAX 
CONNECTOR DB15 
CRYSTAL 

DIODE SCHOTTKY 
DIODE ZENER 
GND EARTH 

GND SIGNAL 
INDUCTOR IRON 
INDUCTOR VAR 
JFET P 

LAMP NEON 
METER MA 
METER UV 
MICROPHONE 
MOSFET N 
MOTOR STEPPER 
NPN DIAC 
PHONEJACK 
PHONEP LUG 

PLUG AC FEMALE 
PNP DAR 

R 

RELAY DPST 
RESISTOR 
RESISTOR TAPPED 
SCR 

SOURCE VOLTAGE 
SPEAKER 

SW PUSHBUTTON 
THERMAL FUSE 


TRANSFORMER AIR CORE 
TRANSFORMER STEPUP 


1RSW10 

1RSW6 

2RSWS 

BATTERY 

BUZZER 

CAPACITOR FEED 
CIRCUIT BREAKER 
CONNECTOR COAX-F 
CONNECTOR DB25 
DIODE 

DIODE TUNNEL 
DIODE ZENER1 

GND FIELD SIGNAL 
GTO 

INDUCTOR IRON1 
INDUCTOR VARIABLE IRON 


JUMPER 
LED 

METER MV 

METER VOLT 
MOSFET DUAL G/N 
MOSFET P 

NPN 


OPTO ISOLATOR 
PHONEJACK STEREO 
PHOTO NPN 

PLUG AC MALE 
PNP DIAC 

R-PACK 

RELAY SPDT 
RESISTOR 8PACK 
RESISTOR VAR 
SIGNAL AC 

SPARK GAP 

SW DIP-4 

SW SPDT 
THERMISTOR 
TRANSFORMER CT 
TRANSFORMER VAR 


1RSW12 

2RSW12 

4 HEADER 

BNC 

CAP 

CAPACITOR POL 
COAX 

CONNECTOR COAX-M 
CONNECTOR DB9 
DIODE BREAKDOWN 
DIODE VARACTOR 
FUSE 

GND POWER 
INDUCTOR 


INDUCTOR ISOLATED 


JFET N 
LAMP 

METER AMP 

METER UA 

METER VU 

MOSFET DUAL G/P 
MOTOR SERVO 

NPN DAR 

OPTO ISOLATOR-A 
PHONEJACK STEREO 
PHOTODIODE 

PNP 

POT 

RCA JACK 

RELAY SPST 
RESISTOR BRIDGE 
RESISTOR VAR 2 
SOURCE CURRENT 
SPARK GAP CAP 
SW DIP-8 

SW SPST 
TRANSFORMER 


TRANSFORMER ISOLATED 


TRANZORB 


SW 


TRIAC TRIAC DRIVER TRIGGERED SKARK GAP 

TRIODE TUBE PHOTO MULTIPLIER UJT N 

UJT P VARISTOR 

Directory of ECL.LIB 

MC10100 MC10101 MC10102 MC10103  MC10104 MC10105 ™Mc10106 = 
MC10107 MC10109 MC10110 MC10111 ™MC10113  ™C10114 ™MC10115 0 
MC10116 MC10117 MC10118 MC10119 MC10121 Mc10123 Mc10124 ci 
MC10125 MC10128 MC10129 MC10130 MC10131 MC10132 MC10133 S) 
MC10134 MC10135  MC10136 MC10137 ™MC10138 ™MC10139 MC10141 3 
F10145A MC10153  MC10154 MC10158 MC10159  ™MC10160 MC10161 am 
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MC10162 MC10163 MC10164 MC10165 MC10166 MC10168 MC10170 
MC10171 MC10172 MC10173 MC10174 MC10175 MC10176 MC10177 
MC10178 MC10179 MC10180 MC10181 MC10182 MC10186 MC10188 
MC10189 MC10190 MC10191 MC10193 MC10195 MC10197 MC10210 
MC10211 MC10212 MC10216 MC10231 F10402 F10414 F10415 
F10416 F10422 F10470 F10474 MC10500 MC10501 MC10502 
MC10503 MC10504 MC10505 MC10506 MC10509 MC10514 MC10515 
MC10516 MC10517 MC10518 MC10519 MC10521 MC10530 MC10531 
MC10532 MC10534 MC10535 MC10536 MC10537 MC10538 MC10539 
MC10541 MC10558 MC10559 MC10560 MC10561 MC10562 MC10563 
MC10564 MC10565 MC10566 MC10568 MC10570 MC10571 MC10572 
MC10574 MC10575 MC10576 MC10578 MC10579 MC10580 MC10581 
MC10582 MC10586 MC10588 MC10590 MC10591 MC10593 MC10595 
MC10597 MC10610 MC10611 MC10612 MC10616 MC10631 F100101 
F100102 F100107 F100112 F100113 F100114 F100117 ¥F100118 
F10012 F100123 F100124 F100125 F100126 .F100130 F100131 
F100136 F100141 F100142 F100145 F100150 F100151 F100155 
F100156 F100158 F100160 F100163 F100164 F100165 F100166 
F100171 F100179 F100180 F100181 F100182 F100183 F100194 
F100402 F100414 F100415 F100416 F100422 F100470 F100474 
F100170/4 

F100170/8 


Directory of INTEL.LIB 


280 Z80PIO 8031 80C31 8032 8035 80C35 
8039 80039 8040 8041 8042 8044 8048 
80C48 8049 80C49 8050 8051 80C51 8052 
8085 B086MAX  8086MIN 8087 8088MAX  8088MIN 8089 
8096 8097 8155 8156 8185 8203 8205 
8206 8207 8208 8212 8216 8226 8231 
8237 8237A 8243 8251 8251A 8253 8254 
82C54 8255 82C55 8256 8257 8259A 8272 
8272A 8273 8274 8275 8276 8279 8282 
8283 8284 8286 8287 8288 8289 8291 
8292 8294 8294A 8295 8344 8396 8397 
8641 8741 8742 8744 8748 8749 8751 
8755 80186 80188 80286 80287 80386 8206-2 
82062 82064 82188 82284 82288 82289 82384 
82501 82530 B2586MA  82586MI 82588HI 82588HM 82720 
82731 

Directory of MEMORY .LIB 

10H8 = 10L8 12H6 12L6 14H4 1414 14L8 16Cl 

16H2 16L2 16A4 #£16R4 16RP4 16x4 16L6 16PR6 
16R6 16H8 $$ 16HD8 1618 16LD8 16P8 16R8  16RP8 
L6V8 ©<16Z8¥  18L4/0mM 18P8! Ol w20ci/!!820L2 %/)20R4 20x4 
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74LS 74S T4ALS 74AS 74HCT 74HC 74ACT 74AC 74F 74 
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Directory of TTL.LIB Continued 


74LS 74S 74ALS 74AS 74HCT 74HC 74ACT 74AC 74F 74 


IT193 Sic ave atte $c S06 200 eae alae 
11194 Sic Si ae ae “60 ae bails} sigs 
11240 ai oe at Se 48 ie xx Ealhad 
11241 30 ere 5 oe ac Sue ae ZF 
11244 Aes ic 50 ¢ oe ans "Ges xx 
11245 ore are ae Se 46 a ittad ali 
2 Sal ois on Ar oe oie oe tethes Eta 
L1253 6 sé ae sac si 36 ae rhe 
BLZS — ote sc ag a aie sufing cs 
11258 ne ae 4c ae a a0 ‘opal rath? 
11280 ane es oe oe ate ar cette eats 
11286 de 56 56 Sat 56 oe gis ‘aft 
11299 one oe ac oe sys one "athad 7s 
1323 Ait oe oc ot ane 56 Maes tots 
11352 a6 me ate are oe ot x eats 
LTS53 ae ore oe sic 5c Se tats isl 
TS HS ere sc ae Ale ate are bt! Elis 
11374 a6 56 Bc a0 Se ae fie) sas 
11640 sic ae ve ae we 310 ax a* 
11643 ane one a6 >< Sic 46 ified Ps 
11881 oe Sc oe 7 Ae 3c xe tthe 
1488 

1489 

75188 

75189 


> 
Uv 
Uv 
m 
= 
Os 
Q | 
m 
” 


A-19 


= ee 


Axibonpt 5S ae —— ee Sy MaRS 


) ar eam De 
een 


——— — 


a TT 
Tt) i 7 ny e § bis 
5t 367 TOA? ees Toe “ea 
| 
4 
ae me ? 
ke’ 4 ? 
" 
¥' My » ' 
= ¥4 ys ; e 
wy x 
4 
4 * 
«*% *e? 
ov * 2? 
ad ‘ 
La a 
- *@ 
- 
~ * 
t < 
ow P 
« * 
yin 


4 


ee pers ae "i! 2 = 
wate ante » 


eae eA fe 


uate vine B31 tarot ae 


Lave 


nig 


ac 


— 


aaet 


Ne 


ee 


eee 24R ae: 
CeLer 


aa 
osset 
saees 
ppast 
pete 
rosea 
cesre 
tron 
R2S¢e 
dase 


APPENDIX B 


DISPLAY DRIVERS LISTED IN RESOLUTION ORDER 


Colors/Type 


Resolution 

320x200 4 
3202006. 
640x200 2 
640x200 16 
640x200 16 
640x350 1 
640x350 4 
640x350 16 
640x400 2 
640x400 2 
640x400 2 
640x400 2 
640x400 Z 
640x400 Z 
640x400 2 
640x400 4 
640x400 16 
640x400 16 
640x400 16 
640x480 16 
640x480 16 
640x480 16 
640x480 16 
640x480 16 
640x528 16 
720x200 4 
720x348 1 
720x348 a 
720x348 1 
720x400 4 
720x696 a 
720x728 1 
752x410 16 
USPS CMOS SEG 
800x600 16 
912x480 16 


1024x1024 16 
1024x1024 16 
1280x400 2 
1280x800 2 


Color Graphics Adapter 
EGA standard monitor 
Color Graphics Adapter 
EGA standard monitor 
Tecmar Graphics Master 
EGA Monochrome monitor 
EGA (64K RAM) 

EGA Enhanced monitor 
AT&T 6300 

HP Vectra Multi-Video 
NCR graphics adapter 
Tandy 2000 Graphics 
Televideo TeleCAT 
Toshiba 3100 Laptop 
Wyse-700 

NCR graphics adapter 
AT&T 6300 DEB 

Sigma 400 

Tecmar Graphics Master 
GENOA SuperEGA 

Matrox PG-640 

Paradise Autoswitch 
TSENG LABS EVA-480 
Video-7 VEGA DELUXE 
GENOA SuperEGA HiRes 
Tecmar Graphics Master 
CPT 9000 Half Screen 
Hercules Monochrome 
Tecmar Graphics Master 
Tecmar Graphics Master 
Tecmar Graphics Master 
CPT 9000 Full screen 
GENOA SuperEGA HiRes 
Video-7 VEGA DELUXE 
GENOA SuperEGA HiRes 
GENOA SuperEGA HiRes 
Vectrix PEPE (AT) 
Vectrix PEPE (PC) 
Wyse-700 

Wyse-700 


CGA4 .DRV 
EGA16C1.DRV 
CGA2 .DRV 
EGA16C2 .DRV 
TGM16N.DRV 
EGA2 .DRV 
EGA4E .DRV 
EGA16E.DRV 
ATT2C.DRV 
HPVECTRA.DRV 
NCR2 .DRV 
TANDY2K.DRV 
TELECAT .DRV 
T3100.DRV 
WYSE700A.DRV 
NCR4.DRV 
ATT16C.DRV 
SIGMA400 .DRV 
TGM16I.DRV 
GENOA640 .DRV 
MATROX64 .DRV 
PEGA640 .DRV 
EVA480 .DRV 
VEGA640 .DRV 
GENOAS28 .DRV 
TGM4N.DRV 
CPTHGC ..DRV 
HGC2 .DRV 
TGM2N.DRV 
TGM4I.DRV 
TGM2I.DRV 
CPTFULL.DRV 
GENOA752 .DRV 
VEGA752 .DRV 
GENOA800 .DRV 
GENOA912 .DRV 
VECTRXAT .DRV 
VECTRXPC.DRV 
WYSE700B.DRV 
WYSE700C.DRV 
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DISPLAY DRIVERS LISTED IN ALPHABETIC ORDER 


Name Resolution Colors/Type 
ATT16C.DRV 640x400 16 AT&T 6300 DEB 
ATT2C.DRV 640x400 2 AT&T 6300 
CGA2 .DRV 640x200 2 Color Graphics Adapter 
CGA4.DRV 320x200 4 Color Graphics Adapter 
CPTFULL.DRV 720x728 1 CPT 9000 Full screen 
CPTHGC.DRV 720x348 1 CPT 9000 Half Screen 
EGA16C1.DRV 320x200 16 EGA standard monitor 
EGA16C2 .DRV 640x200 16 EGA standard monitor 
EGA16E.DRV 640x350 16 EGA Enhanced monitor 
EGA2 .DRV 640x350 1 EGA Monochrome monitor 
EGA4E .DRV 640x350 4 EGA (64K RAM) 

EVA480 .DRV 640x480 16 TSENG LABS EVA-480 
GENOA528 .DRV 640x528 16 GENOA SuperEGA HiRes 
GENOA640 .DRV 640x480 16 GENOA SuperEGA 
GENOA752 .DRV 752x410 16 GENOA SuperEGA HiRes 
GENOA800.DRV 800x600 16 GENOA SuperEGA HiRes 
GENOA912 .DRV 912x480 16 GENOA SuperEGA HiRes 
HGC2 .DRV 720x348 1 Hercules Monochrome 
HPVECTRA.DRV 640x400 2 HP Vectra Multi-Video 
MATROX64 .DRV 640x480 16 Matrox PG-640 

NCR2 .DRV 640x400 2 NCR graphics adapter 
NCR4.DRV 640x400 4 NCR graphics adapter 
PEGA640 .DRV 640x480 16 Paradise Autoswitch 
SIGMA400 .DRV 640x400 16 Sigma 400 

T3100.DRV 640x400 2 Toshiba 3100 Laptop 
TANDY2K.DRV 640x400 2 Tandy 2000 Graphics 
TELECAT.DRV 640x400 2 Televideo TeleCAT 
TGM16I.DRV 640x400 16 Tecmar Graphics Master 
TGM16N.DRV 640x200 16 Tecmar Graphics Master 
TGM2I.DRV 720x696 1 Tecmar Graphics Master 
TGM2N.DRV 720x348 1 Tecmar Graphics Master 
TGM4I.DRV 720x400 4 Tecmar Graphics Master 
TGM4N.DRV 720x200 4 Tecmar Graphics Master 
VECTRXAT.DRV 1024x1024 16 Vectrix PEPE (AT) 
VECTRXPC.DRV 1024x1024 16 Vectrix PEPE (PC) 
VEGA640 .DRV 640x480 16 Video-7 VEGA DELUXE 
VEGA752.DRV 752x410 16 Video-7 VEGA DELUXE 
WYSE700A.DRV 640x400 2 Wyse-700 

WYSE700B.DRV 1280x400 2 Wyse-700 

WYSE700C.DRV 1280x800 2 Wyse-700 


NOTE ON USING AT&T COLOR GRAPHICS DRIVER 


Before this driver can be used, the device driver supplied with 
the DEB card must be installed. The reference manual from AT&T 
has all of the needed information. In summary, CONFIG.SYS must 
contain a line:: DEVICE=DEDRIVER.DEV 


The driver file name may vary based on revision. Also, account 
for the path to the file. 


The DEB card requires special modification to the standard 
monochrome card to be properly set up and to allow color to be 
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displayed. Consult the AT&T reference manual for details. OrCAD 
uses the standard configuration. 


NOTE ON USING TECMAR GRAPHICS MASTER 


OrCAD/SDT III supports Tecmar color and monochrome graphic modes. 
Set the jumpers and switches to their normal positions as 
recommended by Tecmar. The following settings are necessary when 
operating the graphics board in the following modes: 


Monochrome: 
120 x 348 92 color .[Mono! Display] Driver Name is: TGM2N.DRV 
720 x 696 2 color [Mono Display] Driver Name is: TGM2I.DRV 


JPR1 = Position "A" is Not Jumpered 
Position "B" is Jumpered 
Position "C" is Jumpered 

JPR7 = Jumpered 

SW1l = Up 


Color Graphics Mode: 


640 x 200 16 color [Color Display] Driver Name is: TGM16N.DRV 
640 x 400 16 color [Color Display] Driver Name is: TGM16I1.DRV 
720 7X 200 4 color [Color Display] Driver Name is: TGM4N.DRV 
720 x 400 4 color [Color Display] Driver Name is: TGM41.DRV 


JPR1 = Position "A" is Jumpered 
Position "B" is Not Jumpered 
Position "C" is Jumpered 

JPR7 = Not Jumpered 

SWl = Down 


PRINTER DRIVERS 


To configure the printer drivers, there are two files that must be 
contained in the same sub-directory or floppy disk. They are: 1) 
PRINTER.DRV and 2) the desired printer driver used for your 
specific printer. Outlined below, is a list of the supported 
printers and their associated driver names: 


Name Printer Type/Brand 

GITHIS SO -DRVe Ce TTOHNIS50 

CITOHSIOZDRV] Ca ITOH PS10785210 

EPSON .DRV Epson FX/RX, Okidata 192/193 
LQ1000.DRV Epson LQ800/L0Q1000/L91500 

EPSONMX .DRV Epson MX 

HPLASER1.DRV HP LaserJet+,LaserJet II ( 75 dpi) 
HPLASER2.DRV HP LaserJet+, LaserJet II (100 dpi) 
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HPLASER3.DRV HP LaserJet+, LaserJet II (150 dpi) 
HPLASER4.DRV HP LaserJett+, LaserJet II (300 dpi) 
HPINKJET.DRV HP ThinkJet 

JDL750.DRV JDL 750 

JDL850.DRV JDL 850 

NECPR201.DRV NEC PR-201 

NEC8023.DRV NEC 8023 

TI850.DRV TL 850 


TOSHIBA.DRV Toshiba P1340/P1350/P1351/P351 


PLOTTER DRIVERS 


Name Brand 

HP .DRV Use on all Hewlett Packard 
HI.DRV Use on all Houston Instrument 
WG .DRV Use on all Western Graphtek 


CALCOMP1.DRV Refer to Below 
CALCOMP2 .DRV Refer to Below 


NOTE ON CALCOMP PLOTTER DRIVERS 


Outlined below is a list of the supported Calcomp drivers. Note 
that you must have one of the listed Controllers (supplied by 
Calcomp) in order for the plotter to work. Please refer to your 
Calcomp Appendix for your systems configuration. This is a 
difficult plotter to support, since there are many modes of 
operation that are allowed. Be sure you use the correct OrCAD 
driver for the configuration that you have. 
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+------------------ 4--------------------------------- +--------------- + 
| CONTROLLERS | NO CONTROLLER | 
| ~<<—<—-— +----- +------- +-2----- +e---- $¢oo----- $e + 
| SUPPORTED | 907 | 951/ | 960 | Ext960| 
| PLOTTERS | 906 907 | Rev G | 953 | PCI | Format| Format] 
+—----- tee +—----- t—---- +------- +e ----- +----- teo-o---- +------- + 
| | 1012 Xa aoe ll : | . | | 
| | 1037 Xa xey i| Xe | | 5 
yee OH 1038 Xa Xc | | | | | 
Oral 1039 Ka EX Cual | | | | 
he INE HY 1051 tp bea Xe Xc fer ANE A | 

zi | | | | 
[22 1055 Xa 2 2 | 2 | Xa | . 

Uh ais 1060 Xa 2 2 2 (eae y, | xaze 
be 1065 Xa 2 2 2 | Xai y| ‘ 
oe 960 a Xeon woe 2 2 | | xa "| 
L 970 eal 24 | 2 2 | | Xa | 
[Eta | | | 
I 5200 he a al ACES Al | | ° 
lout Gaey! 5500 | : XC ail | | * 
E 5732 er i | GS} | | 
[ee NE eit 5734 | i Xe | | 
T $742 | Xoo] | ° | | 
| | 5744 | Xe | . | | 
5754 | Xc | | : 
t----- $------------ t----- +—---- tee----- t------- t----- teoo---- t------- + 
| | 945 ete 1 Ab u | Xb 
945A | si | al het | Xb 
een 965 zh 1 te it | Xb 
N | 965A | L i | 1 | Xb 
ert | | 
ie = 1042 | 1 eal | Xb 
iy Loe 1042GT | 1 eet: | Xb | 
i, & 1043 are co é 1 a od: | Xb 
ie ees 1043GT i 4s ae a: at | Xb 
ly (Gi al 1044 a een i 1 | Xb 
ee?) 1044GT | . \ { ak | 1 | Xb 
ae ! ! \ \ | | 
lewd LOWS | | i 1 ate al | Xb | 
| LOTS | \ | i a el | Xb 
| | 1076 : | M | 1 oan: | Xb 
| | 1077 Ay i 1 | iu co ° | Xb | 
t—---- tener ne------- +o---- +----- tooo +-o----- +----- +—------- +------- + 
Configuration NOT supported by Calcomp Company. 
Xx Plotter & Controiler configuration supported by Calcomp Company. 


NO DRIVER for OrCAD/SOT IIi. 


a The 906 controller and 960 format can not be supported due to the lack of 
built-in commands to draw circles, arcs, and dashed lines. 


b The extended 960 format is not supported due to a different command 
code structure. 


( The remaining unsupported configurations are due to differences in plotter 
step size. The two CALCOMP drivers use a step size of 2032. We might support 
more drivers in the future which have other step sizes. However, we do not at 
present have the equipment. 


1 Use CALCOMP1.DRV for OrCAD/SDT III 


2 Use CALCOMP2.DRV for CrCAD/SDT III 
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APPENDIX C 


OrCAD SUPPLIED MACRO FILES 


Included on MASTER SOFTWARE DISK 1, are two sample 
macro files: MACRO1.MAC. and MACRO2.MAC. If you 
want to use these macro files, be sure to install the 
appropriate one in the ORCAD root directory. Then, 
configure DRAFT to load the file as outlined in Section 2.4.9. 


Contents of MACRO1.MAC File: 


DRAWING EDITING ( FUNCTION KEYS ) 


RRR KKK KK KK KKK KKK KKEKKKKKKKKK KKK KEKE 


Felts PLACE Wire {F1}=PWB{ } 

F2: PLACE Bus {F2}=PBB{ } 

F3: PLACE Junction {F3}=PIP {ESC} {} 

F4: PLACE Power {F4}=PPP{ESC} {} 

Eo: BLOCK Move {F5}=BMBE { } 

Fé: BLOCK Drag {F6}=BDBE{ } 

F7: EDIT Reference Designator {F7}=EERN{ } 

F8: EDIT Part Value {F8}=EE{D} {ENTER} {ENTER} { } 
F9: ZOOM In {F9}=ZI{} 

F10: ZOOM Out {F10}=Z0{ } 


Contents of MACRO2.MAC File: 


DRAWING EDITING ( FUNCTION KEYS ) 
FI III III II I I II II ae 


Fl: Get Component {F1}=G{ENTER} {MACROBREAK} { } 
F2: Place Wire {F2}=PWB{ } 

ES) eCopy Ob Jece {F3}=BSBEBG{ } 

F4: Delete Object {F4}=DBBE { } 

F5: Move Object {F5}=BDBE { } 

F6: Place Bus {F6}=PBB{ } 

F7: Place Label {F7}=PL{ } 

F8: Place Module Port {F8}=PM{MACROBREAK } { } 


F9: Place Sheet Symbol 

{F9}=PS {MACROBREAK} {ENTER}B{MACROBREAK}E{ } 
F10: Redraw Screen 
{F10}=ZS{D}{D} {D} {ENTER}ZS {ENTER} {ESC} {} 
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DRAWING MANAGEMENT 


KKK KEK KEK KKK KK KKK KKK KKK KKK KKK KKK KK KKK KK 


“Fl: List Components 
“F2: Place Junction 
CES (CODY (ELOCKk 

{*F3}=BS {MACROBREAK} {ENTER} {MACROBREAK} {MACROBREAK } 


“F4: Delete Block 
{*F4}=DB {MACROBREAK} {ENTER} {MACROBREAK } { } 
“F5: Move Block 
{*F5}=BM {MACROBREAK} {ENTER} {MACROBREAK} { } 
“F6: Edit Part Reference 
AE] > -EALTCe Tube: Block 

{*F7}=3X450 {ENTER} JY¥450 { ENTER} EE {MACROBREAK } { } 
“F8: Change Worksheet Size 
{*F8}=ZS{D}{D}{D} {ENTER} {ESC}SW{MACROBREAK} ZS {ENTER} 


“F9: Place Text 
“F10: Show Memory 


ENVIRONMENTAL MANAGEMENT 


( CONTROL KEYS ) 


{*F1}=LD {MACROBREAK} {ENTER} { } 
(*F2}=PJIP {ESC} {} 


BG {} 


{*F 6 }=EERN {MACROBREAK } {ESC} {ESC} {} 


{ESC} {} 
{*F9}=PT {MACROBREAK} {ENTER} {ESC} {} 
a a 0G Fa Oo I 


( ALTERNATE KEYS ) 


KKK KK KKK KEK KKK KKK KKK KKK KKK KKK KKEKKKKK KKK KKK KKKK 


\F1l: SET 
\EZ On 


Auto Pan Off 
Auto Pan On 


\F3: Reference Window 
{\F3}=ZS{D} {D}{D} {ENTER} {MACROBREAK}P{ENTER}ZS1 


\F4: Undo Last Delete 
\F5: ZOOM In 

\F6: ZOOM Out 

\F7: Enter Sheet 

\F8: Leave Sheet 


\F9: SET 
\F10: SET 


\I: * GET 
\C: * GET 
\P: GET 
\G: GET 


Grid Off 
Grid On 


IOB Symbol 
CLB Symbol 
Power Symbol 
Ground Symbol 


{\F1L}=SAN{} 
{\F2}=SAY{} 


{ESC} {} 
{\F4}=DU{} 
{\F5}=Z1I{ESC} {} 
{\F6}=ZO{ESC} {} 
{\F7}=QUEE {ESC} {} 
{\F8}=QUL{ESC} {} 
{\F9}=SGVN{ESC} {} 
{\F10}={ENTER}SGVY {ESC} {} 


{\I}=BI..\LCALIB2K\IOB.BLK{ENTER} { } 
{\C}=BI..\LCALIB2K\CLB.BLK{ENTER} { } 
{\P}=PPV{ESC}VVCC{ENTER}TC{ } 
{\G}=PPV{ESC}VGND {ENTER} TAOB{ } 


* This assumes that you have these objects created in your library 


FILE MANAGEMENT 


COSHEE TS KE Ys) 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKKKK 


SH TR C= Palis 
SHIP T—F2 
4S50{ENTER} 


SHITE T=P3is 
SHIFT=F4s 
SHIFT=Foi: 
SHIFT-F6; 
SHIRT =Fiis 
SHIFT-F8; 
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QUIT Abandon Edits 
Clear Worksheet 


BLOCK Import 

Block Export 

Load Schematic File 
Update Schematic File 
Write To File 

Print Schematic 


{SHIFT-F1 }=QAY{} 
{ SHIFT-F2 }=DBJX450{ ENTER} JY450 { ENTER} BUX- 


JY-450{ENTER}E{ESC}{} 
{SEIFT-F3}=BI {MACROBREAK} { } 
‘SHIFT-F4 }=BE {(MACROBREAK} { ENTER} { } 
{SHIFT-r5}=QI {MACROBREAK} {ESC} {} 

{ SHIFT-F6}=QU {MACROBREAK} {ESC} {} 
{ SHIFT-F7}=QW{MACROBREAK} {ESC} { } 
{SHIFT-F8}=HM{ } 


(€ 


(® 


cy 
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SHIFT=F9; Suspend to DCS (SHIFT-F9}=QS(} 
SHIFT-F10: Save & Abanccn to DOS {SHIFT-F10}=QUA{} 


MOUSE BUTTON ( MIDDLE BUTTON ) 


KEK KKKKKK KKK KKK KKK KKK KKK KKK KK KKK 


MMB: PLACE Wire {MMB } =PWB { } 
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APPENDIX D 


HOW TO WRITE A DRIVER 


OrCAD provides a number of printer drivers for use 
with OrCAD products. If you have a printer not 
supported by an OrCAD driver, you may decide to write 
your own driver. This appendix describes how to do 
that. 


There are two parts to a printer driver: a generic part 
in a file called PRINTER.DRV and a printer-specific 
part whose filename depends on the particular printer. 
OrCAD provides PRINTER.DRV. When this manual 
refers to a printer driver, it means the printer-specific 
portion. For example, one of the Hewlett-Packard 
Laser Jet Plus drivers is called HPLASER1.DRV. 
(OrCAD actually provides four HP laser printer drivers 
called HPLASER1.DRV through HPLASER4.DRV. 
They differ in certain specifications such as bit density.) 


A printer driver is usually written in assembly 
language. It must obey certain conventions as 
described in this appendix describes. 


In addition, this appendix contains the complete source 
code for the following three printer drivers: the 
Hewlett-Packard Laser Jet Plus, the Toshiba P1350, 
and the Epson FX. 


The appendix describes in detail HPLASER1.DRV, a 
driver for the Hewlett-Packard Laser Jet Plus. The 

description points out what features of the driver are 
absolutely required by DRAFT. 
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Appendix D Schematic Design Tools 


D.1 PSEUDO CODE SUMMARY OF A PRINTER 
DRIVER 


A printer driver consists of one far procedure called 
Printer_Driver. The routines within the driver are 
accessed via jmp instructions. The order of the jmp 
instructions is very important. 


For example, the first jmp is to the routine 
Initialize_Driver. When the driver is loaded, the first 
routine in the jmp list is the one that gets executed. 
Consequently, this routine must be Initialize_Driver. 


Here is a pseudo code summary of a printer driver. 
The driver for the HP Laser Jet Plus is used as an 
example. 


Macro definitions 
Define Save_DS 
Define Restore_DS 


Error Code definitions 
K_OK equ 0 


E_No_More_Files bau 18 


STACK segment stack 'STACK’ 
Defines a stack segment called STACK. This is 
defined as an empty segment. The calling program 
sets up the stack. 

STACK ends 


PRINTER segment public PRINTER’ 
Defines a public segment called PRINTER. This is 
the code and data segment for the printer driver. 
Printer_Driver proc far 
List of jmp instructions to the various routines 
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Initialize_Driver: 
Performs any needed initialization. This routine is 
executed when the driver is loaded. It may contain 
commands specific to the printer. 


Get_Printer_Information: 

- Returns a pointer to a printer information table. You 
supply this table at the end of the driver, and it 
contains specific information about your printer. 


Get_Driver_Buffer_ Address: 
Returns a pointer to the buffer where the calling 
program puts the data to be printed. 


Initialize_Sheet: 
Checks the handle of the printer and ensures that 
the printer is in binary mode. Also performs 
functions specific to the printer. For example, the 
HP Laser Jet Plus in placed in graphics mode. 


Completed_Sheet: 
Called at the completion of printing. Performs 
functions specific to the printer. For example, the 
HP Laser Jet Plus is returned to text mode. 


Page Break: 
Outputs a page break. For dot-matrix, continuous- 
feed printers, you can use this command to skip over 
the perforations. 


Output_Printhead_Pass: 
Converts the data in the printer buffer into a form 
readable by the printer. 


Write: 
This routine is not present in the list of jmp's. Itis 
called from within the other routines. It writes a 
series of bytes to the printer. 
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Data Area 
Reserves space for variables and the driver buffer. 
Also defines variables specific to the printer. For 
example, the HP Laser Jet Plus requires the variable 
Enter_Graphics. It is defined as the hexadecimal 
number 1B 2A 74 37 35 52. 


This area also includes the printer information table. 
Finally, the data area must include the variable 
End_Of_File_ Location. The routine 
Initialize_Driver uses this variable's location to 
determine the size of the driver so that it can return 
unused memory to the system. 


PRINTER ends 
end 


D.2 ASSEMBLY AND LINKAGE 


The drivers shown here are intended to be assembled 
with the Microsoft Macro Assembler and linked with 
Microsoft Link. 


For example, consider the driver for the HP Laser Jet 
Plus. Assume that its source code resides in a file called 
HPLASER1.ASM. To assemble HPLASER1.ASM, 
issue the following command (on one line): 


MASM HPLASERI /N /T /Z, HPLASER1, HPLASER1 
/B63; 


where: 

/N Suppresses tables in listing file. 

/T Suppresses messages for successful 
assembly. 

/Z Displays error lines on the screen. 
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/B63 Changes the size of the file buffer used for 
the source file to 63K. 


The assembly produces two files: HPLASER1.OBJ (the 
assembled object code) and HPLASER1.LST (the 
assembly list file.) 


To link the file HPLASER1.OBJ, enter the following 
“command (on one line): 


LINK HPLASER1 /DOSSEG, HPLASER1.DRV, 
HPLASERI1; 


where: 
/DOSSEG Specifies MS-DOS segment ordering. 


The linkage creates a file called HPLASER1.DRV and a 
map file called HPLASER1.MAP. HPLASER1.DRV is 
in .EXE format, but is not separately executable. 


An inference rule for a MAKE file that maintains 
printer drivers is the following: 


.asm.drv: 
MASM $*/N/T/Z,$*,$*/B63; 
LINK $*/DOSSEG,$*.drv,$*; 


The target/dependent description is as follows: 
HPLASER1.DRV: HPLASER1.ASM 
For more information about assembling and linking 


assembly language files, refer to the Microsoft Macro 
Assembler User's Guide. 
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D.3 A MORE DETAILED DESCRIPTION OF A 
PRINTER DRIVER 


D.3.1 Macro Definitions 


A printer driver uses two macro definitions. One is 
called Save_DS, and the other is called Restore_DS. 
The driver routines listed in the jmp list all begin with 
Save_DS and end with Restore_DS. 


Save_DS pushes the current data segment register 
(DS) and the current code segment register (CS) onto 
the stack. It then pops the value of the pushed code 
segment register into the data segment register. 
Finally, it tells the assembler (with an assume 
statement) that the new data segment is the PRINTER 
segment defined in the driver. 


Restore_DS pops the value of the pushed data segment 
register into the data segment register, thus restoring 
the value it had before the routine was called. The 
driver then tells the assembler (with an assume 
statement) not to expect any particular segment 
descriptor in DS. 


D.3.2 Error Codes 


The driver defines a number of symbols to represent 
the conventional DOS error codes. Note, however, that 
the driver defines error code 14, normally undefined by 
DOS. OrCAD defines 14 as the error E_Disk_Full. The 
driver gets that error if it writes to a file and the 
number of bytes written is not the same as the number 
to be written. 


D.3.3 Segment Definitions 


The driver defines two segments, one called STACK 
and one called PRINTER. The driver's data and code 
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reside in the segment called PRINTER. An internal 
stack is not used, but is defined so that assembler and 
linker don't generate error messages. 


D.3.4 The Printer _Driver Procedure 


The Printer_Driver procedure is a far procedure that 
_is identical in structure for all printer drivers. It 
consists of the following: 


¢ Aseries of jmp instructions for each of the printer 

driver routines. Do not alter the order of these jmp 
instructions. The jmp instructions are as follows: 

jmp Initialize_Driver 

jmp Get_Printer_Information 

jmp Get_Driver_Buffer_Address 

jmp Initialize_Sheet 

jmp Completed_Sheet 

jmp Page Break 

jmp Output_Printhead_Pass 


¢ Each of the printer driver routines. The general 
format for a printer driver routine is as follows: 
Save_DS 
<executable code> 
Restore_DS 
ret 
If your printer doesn't use a particular routine, you 
must still provide the routine. In this case, you 
should "stub" the routine -- turn it into a routine that 
does nothing but return. 
¢ The driver routine Write. It does not appear in the 
jmp table. Instead, it is called, when needed, by the 
other routines. 


D.3.5 Initialize Driver 


The Initialize driver routine is executed when the 
printer driver is loaded. This occurs, for example, just 
after DRAFT loads the driver. 


Appendix D Schematic Design Tools 


First, the routine displays a sign-on message. If you are 
writing your own driver, you will probably want to 
make your own sign-on message. 


Then, the driver calculates its size. To do this, it makes 
use of the variable End_Of_File_Location. 
Consequently, this variable must be the last byte in the 
program. The driver then returns unneeded memory 
to DOS. 


D.3.6 Get_Printer_Information and 
Get_Driver_Buffer_Address 


The two routines Get_Printer_Information and 
Get_Driver_Buffer_Address return a pointer in 
ES: Bx 


Get_Printer_Information returns a pointer to the 
printer information table. This table consists of eight 
16-bit words. It must have the following format: 


Number of bits per line for narrow paper 
Number of bits per line for wide paper 
Number of bits per horizontal inch 
Number of bits per vertical inch 

Number of lines per printhead pass 
Number of printhead passes per page 
The size of the driver buffer in bytes 

The size of the driver buffer row in bytes 


If your printer has continuous feed, and you are not 
trying to skip over perforations, set the number of 
printhead passes per page to 0. Otherwise, printhead 
passes per page determines how many times per page 
Output_Printhead_Pass is called. 


Also, be sure to take into account the relationship 


between the number of lines per printhead pass with 
the size of the driver buffer and the driver buffer row. 
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For example, the HP Laser Jet Plus prints one line per 
printhead pass. This line is a row and is stored in the 
entire driver buffer. Hence, lines per printhead pass is 
1, and the driver buffer size and driver row size are 
both 75 bytes. 


However, consider the Toshiba P1350 printer. This 
printer puts out 24 rows at atime. Hence, lines per 

‘printhead pass is 24, and the driver buffer size is 24 
times the driver row size. In general, the value of lines 
per printhead pass determines how many lines the 
routine Output_Printhead_Pass can handle. 


Get_Driver_Buffer_Address returns a pointer to the 
driver buffer. This value is used when making a call to 
Output_Printhead_Pass. 


D.3.7 Initialize Sheet and Completed_Sheet 


The routine Initialize_Sheet is executed at the 
beginning of the sheet. The routine is called only once 
at the start of the printout. Note, however, that if your 
printer driver has a non-zero value for printhead 
passes per page, Page Break would be used for each 
page. 


This routine receives a file handle in BX. This should 
be the handle for the printer or a file. If it is not, an 
error condition results. The routine then forces the 
printer into binary mode and performs any other tasks 
that are specific to the printer. 


The routine Completed_Sheet is executed after a 


printout. It performs printer-specific tasks. The 
routine is called only once at the end of the printout. 
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D.3.8 Page Break 


The Page_Break routine sends a formfeed to the 
printer. The value printhead passes per page 
determines when this routine is executed. 


For example, assume that the HP Laser Jet Plus has 
10-inch pages. Then, at 75 bits per vertical inch, it has 
750 printhead passes per page. After 750 passes, the 
Page_Break routine is called. 


Note that for the laser printer, graphics mode is exited 
and then reentered. 


D.3.9 Output Printhead Pass 


The Output_Printhead_Pass routine converts the data 
in the driver buffer into a format acceptable to the 
printer. For example, a Toshiba printer requires data 
sent to it in columns rather than rows. So 
Output_Printhead_Pass must store enough rows to 
make up a column and then rotate the data. 
Consequently, much of what happens inside 
Output_Printhead_Pass is printer-specific. 


For all printers, Output_Printhead_Pass should 
ensure that any trailing zero bytes are removed from 
the data. This reduces print time. 


When Output_Printhead_Pass is ready to send data to 
the printer, it calls the routine Write. 


D.3.10 Write 


The Write routine sends the data to the handle. The 
handle was passed in via Initialize Sheet. The Write 
routine checks that the written count is the same as the 
to-be-written count. If the number differs, Write 
returns the error code E_Disk_Full. 


D-10 


D.4 SOURCE CODE FOR THE HEWLETT-PACKARD LASER JET PLUS 
PRINTER DRIVER 


PAGE 64,132 
NAME Printer Driver HP_Laser Jet_PLUS 


oe) ep ese es 6107 as ate! 's) a) 0) 8) ed Sip ethe evened 6 eve slielie (sie! 'e @ [5 6 ‘ei 0: ef] 018) 0 6. 616 ene @ aele ele @ © 66 6 6 6 elie. 6 00:6 6 6 0 6 6) 6 S70 6 6 8 


; DECLARATIONS 
Save DS MACRO 
push ‘DS ;save old DS 
push cs 
pop ~ DS ;establish DS addressability 
assume DS:PRINTER 
ENDM 


Restore DS MACRO 


pop DS ;restore DS 
assume DS:nothing 
ENDM 


7;error codes 


E_OK equ 0 

E_Invalid Function clemy a 

E_ File Not_Found equ 2 

E_ Path_Not_ Found equ 3 

E_No_ Handles Left equ 4 

E_Access_Denied equamno 

E_Invalid_ Handle equ 6 

E_Bad_ Control Block equ 7 

E_ Memory Limit equ 8 

E_Bad_ Memory Address equeao 

E_Bad_Environment equ 10 

E_Bad_Format equ 11 

E_Bad_Access_ Code equ 12 

E_Bad_ Data equ 13 

E Disk Full equ 14 

E_Bad Drive Specified equ 15 

E_Current_Dir Remove equ 16 

E_Not_Same_ Device equ 17 

E_No_ More Files equ 18 
STACK segment stack "STACK' 
STACK ends 
PRINTER segment public ‘'PRINTER' 

assume CS:PRINTER 

assume DS:nothing 
PRRRRR RRR RRR ERR TTR TTR R RETR RRR TTT TR RTT TTT 
; Printer Driver 
; interface to printer driver is made with a series of far calls 
; all parameters are passed via registers, the specific registers are 
; detailed for the sub-command 
FO eee 1 ee Pere ae eae eC ee Oe ee a PRO PO PP ON EO PAPE EOE OOOO PRL EE OR OO EEO OO OP OE OE OG RG Oe EF 
Printer Driver proc far 

jmp Initialize Driver 

jmp Get_Printer Information 


D-11 


jmp Get_Driver Buffer Address 


jmp Initialize Sheet 

jmp Completed Sheet 

jmp Page _ Break 

jmp Output Printhead Pass 


Sign_On_Message db 'HP LASERJET (75 dpi) Printer Driver vV3.00',0Dh,0Ah,'S$' 
COPYRIGHT_NOTICE db '(C) Copyright 1987 OrCAD Systems Corporation' 
db ' ALL RIGHTS RESERVED.','S' 


Initialize Driver: sinitialize the interface 
Save _ DS 
; display the program title, revision and copyright notice 
mov DX, offset (Sign_On_ Message) 
mov AH,09h 
int 21h ;print Sign_On Message 
lea DX, Copyright_Notice 
mov AH, 9 
int 21h ; print message 
; return unused memory to the pool 
mov AX,CS ;segment address of this overlay 
mov ES, AX ;recall segment address 
mov BX, offset (End_Of File Location) 
mov CL, 4 
shr BX, CL 
add BX,2 
mov AH, 4Ah ;modify allocated memory blocks 
int 21h 
Restore DS 
reu 


© 0 6 0 8 6 8 Oe 6 SO 0 O10, © 0): 0 O 0 6. 1B Ke Sh OOK e) O10 #80 6) @ (0 eos 0) Sueme lous @ solelisial siiel>).s< lo ellusalse ole lene elle © 0) '« 6 0 © 6 ss SUR 


FREER ER EEE EER ERE EER EEE I ATT ED BP HRW Tr RHE UA Diet GRO R ER eEERELE FOP EE EET Ce eee 6 OF Fe Fee 


; Get_Printer Information 
; pass back a pointer to the Printer Information structure in ES:BX 


o 2 8. e © 6 8 6 5 0 6 ©) © 8 She wi le © Beye) S60 16 aa ieye © 6 #ve Ora) .e.e te! o: ooo wise ete, eieleliene! ee . . cc ee ee eee eee ee 
CRE CEOCEOCEEAPEVEDER ED OOF. FPLELPI ED FIED GUE BAR PC LGRERE PAPE: PAPHENEME TAKE RE IE PRL PHONE NAL IEP Foghe FENG: FP Eo eee 


Get_Printer Information: 


Save_DS 

mov BX CS 

mov ES, BX 

mov Bx, offset (Printer Information) 
Restore DS 

ret 


oO 8 6 8 O18 6 Oo & 8 © ET6 6 So (6 oS Oe oS Byers) 2 6 0 "s. 's 2:6 6.6 00s 9 © 8 & 0) 0 6. 6 w 8 « 8 6! @ 6) 8 6 © » « s''o 6 o PileNaus) os «fe wile! eum) (silo 


CEP EO OEE MG EEE OEM CE EE RSF EE EOE EOE ROE OE EF £2 EE ORS CEO PPLE SO BOI 2 eee Fe ror eee 
; Get_Driver Buffer Address 

; pass back a pointer to the Driver Buffer in ES:BX to be used for 

; future calls to Output_Printhead Pass 


re er 


PEC OCOC LCR GO Oe OE ME EO EE ODE OREO EF OD OO FOP OL DOOR OOOO ETRE REP OE. OEE 0) 8) RPO) Oe ORO Oe 10 0 OF sil een 


Get_Driver Buffer Address: 


Save_DS 

mov BX,CS 

mov ES, BX 

mov BX, offset (Driver Buffer) 
Restore DS 

ret 


© 0 6 © 6 © 6 6 oe Fale Ss el eel eos) 6 ele che ere) ele fol e. @ 6 sf ecole @!,9) 6. (6 Seleue “a Shens eile) e .¢ & (9 6 @ #8) ¢ mw a) |e) © ole eenes s:6) ss) 5) (eels 


GEOR ELE EAL DECOR GEL OGG SD V0. BEGG PROBL OF BAF Pict 2IVTE ENO! FLIED OLE Be OEE FOPLR, FF 0x0 eUURE D PPP ent) to Pree 


; Initialize Sheet 
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5 pass in HANDLE in BX, destination of this sheet, already opened 


; HANDLE will be checked here to ensure binary mode 
; initial commands written to the HANDLE 
; pass back STATUS in AL 
Initialize Sheet: ;initialize the driver for a new sheet 
Save_DS 
mov Handle, BX ;save handle for later routines 
; check handle 
mov AX, 4400h 
int “21h ;get information on handle 
ake: IS Exit ;if error, exit 
testy. —DL7.80h jis handle for a device? 
5z IS Write 
or DX, 0000000000100000b ;force binary mode 
xor DH, DH 
mov AX, 4401h ;set device information 
int PAM 3 
ie IS Exit ;l£ error, exit 
IS Write: 
lea DX, Enter Graphics ; transfer the ENTER GRAPHICS command 
mov BX, Handle 
mov CX 
call Write 
TSUExXit: 
Restore DS 
ret 
OD OU OIG OOF EE AD ELE BIRT AOI One pera a Ee GeO Gold PENTA CMERE Et ERA Ce Oe 
; Completed Sheet 
; write to HANDLE at the end of the sheet printing 
Z pass STATUS back in AL 


cece eeecee 2 Se 6 '¢) #19) eee eer eer s) 2) 01 Ses, 018 (6 (6) 018) @ -& (0) 6 00. e) 16, Se) 0) 's 6 0) 8 Nw e016) © 6) 0.6 @ © 8 016 6) 0, 6 6 9) 6 0, 6. 68 6) 0 8,68 
FRESE SELLS, POI OROL EO OOO IRE LOS ERIRE COPE OOP ELD OEP OOK OE PIE OIE LO OEE DOE LEE OOO OMA OF EO OO EOL ECD 


Completed Sheet: 


Save DS 

lea DX, Leave Graphics ;transfer the LEAVE GRAPHICS command 

mov BX, Handle 

mov CX, 5 

call Write 

Restore DS 

ret 
BEB ROIEG GE OIE PURE ADE DST GS Patan Tao T I PR aul OL ERLE CR DELLE APEED CAL EPR ae ELBE UE a 
; Page Break 
; suspend printing on the current page, send form feed, restore printing 
; return STATUS in AL 


Page Break: 


Save DS 

lea DX, Leave Graphics ;transfer the LEAVE GRAPHICS command 
mov BX, Handle 

mov CXF 256 

call Write 

Restore DS 

ret 


eee ec eee eee e ee 
SE GEO COC ese Oe 


; Output_Printhead_ Pass 
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; convert the Driver Buffer into a format that the printer will use 
; remove all trailing zero bytes to reduce print and transfer time 
; return STATUS in AL 


coe eee eee eee eee eee reese reese eres eee eeee eee seer eee ereeeeseererseereeereeeeeeeesese 


CERO E LE OEL ERE EDAD D BOF FE FE PAR FMI ONO POPP CDF 027 DEE ELE FOU bE ERERILC ISIE Bib PAE ELE FUEL Foe: even pL 


Output_Printhead Pass: 


Save _DS 
; reduce the transfer count to eliminate trailing zeros 
mov CX,Driver Buffer Size 
mov AX,DS 
mov ES, AX 
mov BX, CX 
dec BX 
lea DI,Driver Buffer [Bx] 
xor AL, AL 
std 
rep scasb 
; convert the value in CX to a printer byte count 
inc CX 
mov Row_Count, CX 
mov AX, CX 
xor DX, DX 
mov CTO 
div CL 
add AH, '0' 
Mov Printer Code[5],AH 
mov AH, AL 
xor AH, AH 
div CL 
add AH, "0." 
Mov Printer Code[4],AH 
mov AH, AL 
xor AH, AH 
div CL 
add AH, '0' 
mov Printer Code[3],AH 
; transfer the graphics row leadin 
mov CXP7u 
lea DX, Printer Code 
cali Write 
jne OPP_Exit 
* transfer the graphics row 
mov CX, Row_Count 
lea DX,Driver Buffer 
call Write 
jne OPP_Exit 
OPP_Exit: 
Restore DS 
ret 


Printer Driver endp 
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transfer bytes to the HANDLE 
pass in address of data in DS:DX 
pass in byte count in Cx 

return STATUS in AL 


2 0: 6's © c 6 © 6.8 0 © 6 0 8 6 0 6 0.6 6 6 + 0» 6 wo 0 © els © © 6 0 6 6 oe 6 ele oes 0s 6 bes ss a6 ©» 
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Write proc near 


assume DS:nothing 


mov BX,CS:Handle 
jcxz Write Exit 
IFDEF NEC 
cmp BX, 4 jis the handle the printer? 
je Write PRN ;if yes, jump 
ENDIF 
mov AH, 40h 
push "ex ;Save count for later check 
int 21h 
pop CX precall count 
ae Write Exit 
cmp AX, CX ;compare written count 
mov AL,E Disk Full ;if written count <> write count 
jne Write Exit ; then disk must be full 
mov AL, E_OK 
Write_Exit: 
ret 
IFDEF NEC 
Write PRN: 
push DS 
mov BX,DS 
mov ES, BX jaddress of buffer is ES 
mov BX, DX ;address of buffer is BX 
mov AH, 30h ;block write 
int 1Ah 
shr AH, 1 
shr AH, 1 ;if error, carry is now set 
pop DS 
mov AL, E_Access_Denied 
ic Write Exit 
mov AL,E_OK 
jmp Write Bxit 
ENDIF 
Write endp 


eos eece seer eo eee ees eee seer eee e eee ee ees ees eee eeee eee eeeeeeereeeeseeeeeesee2ee22 22280 2 © 
tee APO oO PP OOO IR OE OE Le CRUDE LU PT OARS FFE DP OPENERE. PLE FP OP CURE V ELE. FOO E OO COOLER OCP CEE OE Ve 


; DATA AREA 


oor ere sce ee ee eee see eee eee eee see eee eee eer ese ee ee sees eeeereeoeeseeseeeesereeeeeeres eres ee eee 
Pee Ee OOOO Ne EE PERO ce FETE BAB OAO I LTD DO Tet ae 068: CROP ERI. DYOLP EVIE EXPER O TS BOOLE BOO FE OLR EEE EEL e Oe Ft 


Handle dw 2 
Row_Count dw 2 
Leave Graphics db LBh; }*rBe 
db 0Ch 
Enter Graphics db LBh se voR 
db 1Bh,'*xr0A'! 
Printer Code db 1Bh, '*b000wW' 
GUPURUPAI LF TEL ELON FRR ole FIRE EID 6K CLE T GOHG GURMRAPTD DET CURMPMERUR REL? BXMUEAALS CHIDON, GE DEERE CORE RR EEE FEE 
Driver Buffer db 75 up (2) ;buffer to pass bits into 
Pee tee rl Ce meen ee Pee eae OF eee Cs Cle Peete Le CIO OF OOS OPO COO CE EO CE CEO ELL EERO eC OF OM Se 
Printer Information dw 600 ;bits per line (narrow paper) 
dw 600 ;bits per line (wide paper) 
dw Ws ;bits per inch (horizontal) 
dw TS ;bits per inch (vertical) 
dw aE ;lines per printhead pass 
dw 750 ;printhead passes per page 
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;<<<NOTE>>> set the printhead passes per page to 0 if continuous paper 
Driver Buffer Size dw aS ;Driver Buffer size (in bytes) 
Driver Buffer Row Size dw 5 ;Driver_Buffer size (in bytes) 


Cc 


PEO OE GEO CEE OOO EOE EVE OCR OT OR CPE PCD GPO EW REE TO TET AE TED, FEAF PAP GOP OE OP Oa) OP ee 


; the following must be the last declaration so that the memory size used by 
; the driver can be reduced 
End_Of File Location db ? 


PRINTER ends 
end 


D.56 SOURCE CODE FOR THE TOSHIBA P1350 PRINTER DRIVER 


PAGE 64,132 
NAME Printer Driver Toshiba 


Ce 


FEC EF EOE OR ELEC EFE OEE OREO RGU EF EEE DEG EE ENG OEE FOOLS IEE CLL OL EEE DO OL OED CO ORE eep eee re 
; DECLARATIONS 


ee 


GERM EE CPOE EEE EERE RP ECU EV REE VEC CECE DIE VRE OEE OCU FV VE FOE U0 2 CPRD 0 Cu Pare Fee ee 


Save_DS MACRO 
push DS ;save old DS 
push cs 


pop DS ;establish DS addressability 
assume DS:PRINTER 
ENDM 


Restore DS MACRO 


pop DS ;restore DS & 
assume DS:nothing ‘ 
ENDM 


;error codes 


E_OK equ 0 
E_Invalid Function equ 1 
E File Not_Found equim. 
E_Path_Not_Found equ, 3 
E_No_ Handles Left equ 4 
E_ Access Denied equ 5 
E_Invalid_ Handle equ 6 
E_Bad_ Control Block equan/ 
E Memory Limit equ 8 
E_Bad_ Memory Address Sei 1g 
E_ Bad Environment equ 10 
E_Bad Format equa 
E_Bad_Access_Code equ 12 
E_Bad Data equ 13 
E_Disk_ Full equ 14 
E_ Bad Drive Specified equ 15 
E_Current_Dir_ Remove equ 16 
E_Not_Same_Device equ 17 
E_No More Files equ 18 
STACK segment stack 'STACK' 


STACK ends 
PRINTER segment public 'PRINTER' 


assume CS:PRINTER 
assume DS:nothing 
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cece nee eee eee opined PLS Ray oe Re eee S eave) iw ejite: <0. taille. 0) (eT AM TS) (eT! iw elation miienaIG.Ta sve. 6 a) @ is 6:6: wt 6 © 68 (0 © 6 eles te 
RCE LUTE OCC TeV e War NLRVe MEME INTER RARE I POI ERS TOBE ONES PIPES DEP IE PURE EO PMENIT ONE COE POE ELE EER REECE RE 


interface to printer driver is made with a series of far calls 


5 all parameters are passed via registers, the specific registers are 
3 detailed for the sub-command 


cee ee ee woe O\ 8) 6) eee) 6 a) )6) je, (6) 6918 © 16. ie! Sle @)'e) 0 6.8 6 ie) alls) se 
SAE te CGR CR ARON SPEEA OREO I CEE PAO PRION G DEI SA DNE SLI SED APUR OE PEEOR PEEL INELELEE ELE EER CE DE Rh OB OS 


Printer Driver proc far 


jmp Initialize Driver 

jmp Get_Printer Information 
jmp Get_Driver Buffer Address 
jmp - Initialize Sheet 

jmp Completed Sheet 

jmp Page Break 

jmp Output_Printhead Pass 


Sign_On_Message db 'Toshiba 1350 Printer Driver v3.00',0Dh,0Ah,'S' 
COPYRIGHT_NOTICE db '(C) Copyright 1987 OrCAD Systems Corporation' 
db ' ALL RIGHTS RESERVED.','S$! 


Initialize Driver: ;initialize the interface 
Save _ DS 
; display the program title, revision and copyright notice 
mov Dx, offset (Sign_On_Message) 
mov AH, 09h 
int 21h ;print Sign_On_ Message 
lea DX,Copyright_Notice 
mov AH, 9 
init 21h ; print message 
; return unused memory to the pool 
mov AX,CS ;segment address of this overlay 
mov ES, AX ;recall segment address 
mov BX, offset (End_Of File Location) 
mov CL, 4 
shr BX, CL 
add BX, 2 
mov AH, 4Ah ;modify allocated memory blocks 
int 21h 
Restore DS 
Lec 


7; Get_Printer Information 
, pass back a pointer to the Printer Information structure in ES:BX 


coe coe ee ew ee ewe Psu el Se Sasol Se TAT Te (See 18) 818) 6 a dele ie. ele. lee) @ hee wb: 1Setinl © ie) 4. lee) 6.6) 6 in, 8. (MGM AN 6: 6. 'e' 6) ©; 6 is eB. 01 le @) 6-18 ®. ele 
COOL ONE ee OE ID IE EOE OED EI EES IA GAD POP AF DOD FU IDRINELE FP DPE OR OCR EEC EE RARER OFE REST 


Get_Printer Information: 


Save_DS 
mov Bx,CS 
mov ES, BX 
mov BX, offset (Printer Information) 
Restore DS 
rec 
POCEPERE EGO ODE UREE OG ED HG Bp TAH Cp COO COTE BERLE EOD hh DORA Cette ELLE I aE 
; Get_Driver Buffer Address 
; pass back a pointer to the Driver Buffer in ES:BX to be used for 
; future calls to Output_Printhead_ Pass 
ROP ODER EG OBOE 8 OEE REGO BD LOE BIS OE LH TE LDDs RESTA flare te PPR ICA. MeDkeah SL EEE Pi Ca ea aera 
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Get_Driver_ Buffer Address: 
Save_DS 
mov ES,Driver Buffer_s 
mov Bx, 0 
Restore DS 
ret 


; Initialize Sheet 
; pass in HANDLE in BX, destination of this sheet, already opened 
5 HANDLE will be checked here to ensure binary mode 


Allocate memory for arrays 
9 pass back STATUS in AL 
Initialize Sheet: ;initialize the driver for a new sheet 
Save_DS 
mov Handle, BX ;save handle for later routines 
; check handle 
mov AX, 4400h 
int 21h ;get information on handle 
jc TSUExXit sif error, exit 
test DL, 80h jis handle for a device? 
jz IS_ Allocate ;if not, skip binary mode set 
or AX, 0000000000100000b ;force binary mode 
xor DH, DH 
mov AX, 4401h ;set device information 
int 20h 
IS_ Allocate: 
mov AX, Image _Data_s @ 
or AX, AX 
jnz IS_DB ;if segment <> 0 , do not reallocate 
mov BX, Image _Data_ Size 
mov CL, 4 
shr BX, CL 
inc BX 
mov AH, 48h 
int 21h 
je IS_Exit 
mov Image _Data_s,AX ;Image_Data array segment 
IS_DB: 
mov AX,Driver Buffers 
or AX, AX 
jnz IS Exit _OK ;if segment <> 0 , do not reallocate 
mov BX,Driver Buffer Size 
mov CL, 4 
shr BX, CL 
inc BX 
mov AH, 48h 
int 21h 
ake’ IS_ Exit 
mov Driver Buffer _s,AX ;Driver Buffer array segment 
IS-Exit OK: 
mov AL, 0 ;return Status=0 
IS_ Exit: 


Restore DS 
ret 
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Completed Sheet 

write to HANDLE at the end of the sheet printing 
free previously allocated memory 

pass STATUS back in AL 


Q me Me Me Me Me 
xe 
Ne 
™e 


LIAO AMMORON L028 ethan AARP GMP ASN Y ARIMONGD CAE LETANG) tat Gt CL ELALOLLACRY. tututgah teed paplene Ghenive) pune eGR GED Gf tin te 
ompleted_ Sheet: 

Save _DS 
mov AX, Image Data_s ;return Image Data array 
Or - AX, AX 
jz CS_DB ;if segment value = 0 then do not free 
Mov Image_Data_s,0 
mov ES, AX 
mov AH, 49h 
int 21h 
je CS_Exit 

CS_DB: 
mov AX,Driver Buffer _s ;return Driver Buffer array 
or AX, AX 
jz CSarE ;if segment value = 0 then do not free 
mov Driver Buffer _s,0 
mov ES, AX 
mov AH, 49h 
int 21h 
jc CS _ Exit 

CS_FF 
lea DX, Form_Feed ;transfer a form feed 
Mov BX, Handle 
mov CxX,1 
call Write 

CS_Exit: 
Restore DS 
ret 

page ueenk. 


suspend printing on the current page, send form feed, restore printing 
return STATUS in AL 


coo ece ee ee eco eee sees eo ese eee 


ECP PONS D CYMER ONP AR AGLURYAPRONINOTOAFAGLOMISY 6 BE ETD EE Bg FAR Pf? GbE EPID COTE CE RECEP EERE OES 


age_ Break: 


WO se se Ne Me Ne 
™ 
™ 
‘eo 
eo 


Save _DS 

lea DX, Form Feed ,eransfen a form feed 
mov BX, Handle 

mov CX,1 

call Write 

Restore DS 

ret 


a 


=e 
= 
ée 


convert the Driver Buffer into a format that the printer will use 
remove all trailing zero bytes to reduce print and transfer time 
return STATUS in AL 


cee ee . ec e ee eee eee ee oes eee eee eee eee ese ee ee eee sees eee ereeeeeeerere seers 
PAEE AU EPP LLONE DOOTPE ER COE 8 EOF OUR ELULE. OE F OLE 0.E OEE GuAPRILE CUELT CPF OLEPRU CREO DEE EEOORERE OE? 


_Printhead Pass: 
Save_DS 
mov ES, Image Data_s ;segment of Image Data array 
xor AX, AX 
Mov DI, AX 


es Se Se Se Me Me 
so 


ue) 
c 
ct 
tJ ss 
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mov 
shr 
rele | 
rep 


CX, Image Data Size 
CX, 1 


stosw 


;clear the image data 


* convert the Driver Buffer into the Image Data array 
; Driver Buffer is formatted as 24 rows of 2448 bits 
; Image Data is formatted as 2448 groups of 4 bytes 


mov 
push 
mov 
mov 


assume 


OPP_Loop: 
Mov 
Mov 
mul 
Mov 
Mov 
shl 
mov 
mov 


OPP_Line Loop: 


lodsb 
or 
Zz 
OPP_Test_80h: 
test 
SNe 
or 
OPP_Test_40h: 
test 
a4 
or 
OPPelestmzon: 
cest 


OPPe Test 10h: 
test 
3A 
or 

OPP_Test_08h: 


OPP_Test_04h: 
test 
hz 
or 

OPPaTests 02h: 
test 
NZ 
or 

OPP_Test_Oth: 
test 
az 
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Printhead Line, 0 
DS 

ES, Image_Data_s 
DS,Driver Buffer _s 


DS :nothing 


AX,CS:Driver Buffer Row Size 
BX,CS:Printhead_ Line 

BX 

SI,AX 

AH,CS:Set_Bit [BX] 

BX, 1 

DI,CS:Which_Byte [Bx] 
CX,CS:Driver Buffer Row Size 


AL, AL 
OPP_Next_Byte 


AL, 80h 
OPP_Test_40h 
byte ptr ES:[DI ],AH 
AL, 40h 

OPP_Test_20h 

byte ptr ES: [(DI+4 ],AH 


AL, 20h 
OPP_Test_10h 
byte ptr ES:[(DI+8 ],AH 


AL,10h 
OPP_Test_08h 
byte ptr ES: [(DI+12}],AH 


AL, 08h 
OPP_Test_04h 
byte ptr ES: [DI+16],AH 


AL, 04h 
OPP_Test_02h 
byte ptr ES: [(DI+20],AH 


AL, 02h 
OPP_Test_01lh 
byte ptr ES: [DI+24],AH 


AL, 01h 
OPP_Next_Byte 


array 


;offset into Driver Buffer 
;which bit to set for this line 
;convert to word index 
;which byte to set for this line 


get byte from Data Buffer 


;set bit 


bit 


,set 


bit 


73sec 


lopite 


,set 


bit 


,set 


bit 


,set 


;set bit 


in 


in 


in 


in 


in 


in 


in 


Image _ Data 


Image Data 


Image Data 


Image_Data 


Image Data 


Image Data 


Image Data 


0 then skip bit checks 


array 


array 


array 


array 


array 


array 


array 


or byte ptr ES: [(DI+28],AH 


OPP _Next_Byte: 


;set bit in Image Data array 


add DI, 4*8 snext 8 bit block 

loop OPP_Line Loop ;continue for all bytes on line 
mov AX,CS:Printhead_ Line 

inc AX 

mov CS:Printhead_Line, AX ;save net printhead line number 
cmp AX,CS:Printhead_ Line Count 

jne OPP_Loop ;Loop for all printhead lines 
pop DS 

assume DS:PRINTER 


*; reduce the transfer count to eliminate trailing zeros 


° 
, 


mov ES,Image_Data_s 

MOv CX, Image _Data_ Size 

mov Di, Cx 

dec DI 

xor AL, AL 

std 

rep scasb 

and CX, OFFFCh 

add CX, 4 

mov Row_Count, Cx 
convert the value in CX to a printer 

mov AX, CX 

shr AX,1 

Seb AX,1 

xor DX, DX 

mov CL, 10 

div CL 

add AO} 

mov Printer Count (3],AH 

mov AH, AL 

xOor AH, AH 

div CL 

add AH, '0' 

mov Printer Count [2],AH 

mov AH, AL 

xor AH, AH 

div CL 

add AH; *0" 

Mov Printer Count[1],AH 

mov AH, AL 

xor AH, AH 

div CL 

add AH OE 

mov Printer Count([0],AH 
transfer the graphics row leadin 

lea DX, Printer Code 

mov CX, 6 

call Write 

jne OPP_Exit 
transfer the graphics row 

mov CX, Row_Count 

push DS 

mov DS, Image _Data_s 


;segment of Image Data array 


;offset of last element 


;save number of bytes to write 
byte count 
7;Max value of AX=2448 


;byte count/4 


;segment of Image Data 
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> 
0 
Uv 
m 
= 
Si 
OQ 
m 
n 


assume DS:nothing 


mov Dx, 0 
call Write 
pop DS 


assume DS:PRINTER 


jne OPP_Exit 
; transfer the graphics row end of line 
lea DX,End_Of_ Line 
mov Cx, U0 
Call Write 
jne OPP_Exit 
OPP_Exit: 
Restore DS 
ret 


Printer Driver endp 


; Write 

; transfer bytes to the HANDLE 

; pass in address of data in DS:DX 
: pass in byte count in CX 

; return STATUS in AL 


Write proc near 


assume DS:nothing 


mov BX,CS:Handle 
apebe4 Write Exit 
IFDEF NEC 
cmp BX, 4 jis the handle the printer? 
je Write PRN ;if yes, jump 
ENDIF 
mov AH, 40h 
push CX ;save count for later check 
int 21h 
pop CX ;recall count 
aK Write Exit 
cmp AX, CX ;compare written count 
Mov AL,E Disk Full ;if written count <> write count 
jne Write Exit ; then disk must be full 
mov AL,E_ OK 
Write Exit: 
rec 
IFDEF NEC 
Write PRN: 
push DS 
mov BX,DS 
mov ES, BX ;address of buffer is ES 
mov BX, DX ;address of buffer is BX 
mov AH, 30h ;block write 
int 1Ah 
shr AH, 1 
shr AH, 1 ;if error, carry is now set 


r 
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pop DS 


Mov AL,E_Access Denied 
jc Write Exit 
mov AL, E_OK 
jmp Write Exit 
ENDIF 
Write endp 


a 


POP CORRE ROPE 0 ICED Oe PaO Pa ee CORR DEL OES RACE CE ECL OL OLELOLe PLEAl CPELP Rte OOO COE OO BE OO RR EO RES 
. 
; DATA AREA 


eee eee eee eee eee eee ese eee ees e eee eee see ee ereeree eee e eee ere ee eee erere sre eee eee e eee eevee 


EC DESY LAE DNR TOT Soa? 8 D7 I TAR TREC AY ROY DS ONT BRE AT ALY’ Tibt JORE DCAM ASST Me ORF Dea Saal Ti A TY 2 SEN et RAE AY A Zit ae CRY AM a A EO A coy A Ae a Se le 2 Je? dla a Se a a lO 


Handle , dw 0 
Row_Count dw 0 
Form_Feed db 0Ch 
End_Of Line db 1Bh, 'L07", 0bh,,OAn,LBh, 1408" 
Printer Code db TB yee 
Printer Count db "0000' 
Image _Data_s dw 0 ;segment of Image Data array 
Image_Data_Size dw 2448*4 
Set_Bit db 20h,10h,08h,04h,02h, 01h 
db 20h,10h,08h,04h, 02h, 01h 
db 20h, 10h, 08h, 04h, 02h,01h 
db 20h,10h,08h,04h,02h,01h 
Which_Byte dw OR 0-207) OpemOre £O 
dw Bay tle eed als Ly Lee 
dw 2eiecipeoes Glin Beer Fe 
dw 37 on) or Sal bc ae 
Printhead Line dw 0 
Driver Buffer_s dw 0 ;segment of buffer to pass bits 
Printer Information dw 1440 ;bits per line (narrow paper) 
dw 2448 ;bits per line (wide paper) 
dw 180 ;bits per inch (horizontal) 
dw 180 ;bits per inch (vertical) 
Printhead Line Count dw 24 ;lines per printhead pass 
dw 0 ;printhead passes per page 
7 <<<NOTE>>> set the printhead passes per page to 0 if continuous paper 
Driver Buffer Size dw ((2448+7) /8) *24 
Driver Buffer Row Size dw (2448+7) /8 


coerce eer eee ee eee ese eee eer eee seo eee ose eee e reese sere ee see oe ees ese eee ees eee ee eee eee eee 
PERE ONE Ou OO AO OP Cee 8 elie OO Rae OLR Oe POO IRE EOE EL OME EG ERE COR ORC OE COS OC EC EF EEO EL EO VL 


; the following must be the last declaration so that the memory size used by 
; the driver can be reduced 
End_Of File Location db 2 


PRINTER ends 
end 


D.6 SOURCE CODE FOR THE EPSON FX PRINTER DRIVER 


PAGE 64,132 
NAME Printer Driver EPSON FX 


eo ec eee er eee eee eee eee eee eee ese eee ose sore e eee esee esos eee eee eee eee eee ese eee eeeeesese se 
Sak 0 Cae 0. Oras Pee e ae SEER BAFFLE LWP ER PES OOK GO C8 PPI EU DE OO OC OLD OL AAI hAI Rk DAOC LO LED OP ELECT COED 


; DECLARATIONS 


ce ee eee eee eee eee eee seer sree e ese osee reese ereereereee eee eee eee eseeeseesesseeree ees eesee eee 


Save_DS MACRO 


SADIGNAddV 
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push DS 7;save old DS 


push cs 
pop DS ;establish DS addressability 
assume DS:PRINTER 

ENDM 


Restore DS MACRO 
pop DS ;restore DS 
assume DS:nothing 
ENDM 


;error codes 


E_OK equ 0 
E_Invalid Function equ 1 
E_ File Not_Found equ 2 
E_Path_Not_ Found equ 3 
E_No_ Handles Left Get 4 
E_Access_ Denied ei Ss 
E_Invalid Handle fen 1G 
E_Bad_ Control Block Ceiee 4 
E_Memory Limit equ 8 
E_Bad Memory Address equ 9 
E_Bad_ Environment equ 10 
E_Bad_ Format equ 11 
E_Bad_Access_Code equ 12 
E_Bad Data SCS 
E_Disk_Full equ 14 } 
E_Bad Drive Specified equ 15 
E_ Current Dir Remove equ 16 
E_Not_Same_ Device equ 17 
E_No More Files equ 18 
STACK segment stack 'STACK' 


STACK ends 


PRINTER segment public 'PRINTER' 
assume CS:PRINTER 
assume DS:nothing 


FORE RECEEER TEES EES SELLS SED NSE SS eis iw 2 F's) © ole wise Ss 60) wee) Suelo © SHON E e681 6) eG) ele) 6. 6) o) a) oieitanienre ran 
COOOL ELLE EEO RE LURID E ILE OVE DELI VOIGT ELI DOL OD ROE DR £1 CULE WEIR BHA CET ELE Cee 


*; Printer Driver 

; interface to printer driver is made with a series of far calls 

; all parameters are passed via registers, the specific registers are 
; detailed for the sub-command 


FRCEOECLEEEE CREE 2 ET DE 8 eo Soe Oe en 6 (018) 9: \0) =: ole © 0 6.0 410 oe 4:6) 8 \e's' 0: 6.010 0) 6. 6, 61.5) a.l0, 16, eal ote 


Printer Driver proc far 


jmp Initialize Driver 

jmp Get_Printer Information 
jmp Get_Driver Buffer Address 
jmp Initialize Sheet 

jmp Completed Sheet 

jmp Page Break 

jmp Output_Printhead Pass 


Sign_On_ Message db 'EPSON FX Printer Driver .v3.00',0Dh,0Ah, '$! 
COPYRIGHT_NOTICE db '(C) Copyright 1987 OrCAD Systems Corporation' 
db ' ALL RIGHTS RESERVED.','S'! 
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Initialize Driver: yinitialize the interface 


Save DS 
; display the program title, revision and copyright notice 
mov DX, offset (Sign_On_ Message) 
mov AH, 09h 
int 21h *;print Sign_On Message 
lea DX, Copyright _Notice 
mov AH, 9 
int 21h ; print message 
; return unused memory to the pool 
mov AxX,CS ;segment address of this overlay 
mov ES, AX ;recall segment address 
Mov BX, offset (End_Of File Location) 
mov CL, 4 
shr BxX,CL 
add BX,2 
mov AH, 4Ah ;modify allocated memory blocks 
int 22h 
Restore DS 
cect 
PBC EDITOR BOT OO Dra Bid Be ee BG 2 Bitis Derere aac rete lira had racic OE EE 07 D CLEREREL Etat th CLEARER Ota CA ee 
; Get_Printer Information 
; res back a pointer to the Printer Information structure in poet 
Get_Printer Information: 
Save_DS 
Mov BX,CS 
mov ES, BX 
MOv BX, offset (Printer Information) 
Restore DS 
Zec 
; Get_Driver Buffer Address 
; pass back a pointer to the Driver Buffer in ES:BX to be used for 
fi future calls to Output_Printhead Pass 
PETRIRO! CF BREEN LVh gs? shiphae Ph eh Eigh Bo SEL UAERGUPM ECF URLEN EEL ets eb) DRORTA RTE RERE TP OOTELE BLEUE ONC CORES COR OR Rae oa 
Get_Driver Buffer Address: 
Save_DS 
mov ES,Driver Buffer _s 
mov Bx, 0 
Restore DS 
Tec 
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Initialize Sheet 
pass in HANDLE in BX, destination of this sheet, already opened 
HANDLE will be checked here to ensure binary mode 

Allocate memory for arrays 

pass back STATUS in AL 


sect reese ee sere eee eee eee eee e reer eee ee sere reer ee see eeeseeree cere ee eee ee eee ee ee 


Se Se Be Ne Ne 


PRP ET A DERMOT NG A FOPAORONE COE TUCME NEUE TELE GUGRLOD GORLCAG FE FOE EOE LO OLED CADRE TE CRORE EEE CEERE CEDURE > 
Initialize Sheet: sinitialize the driver for a new sheet Uv 
Save_DS f. 
mov Handle, Bx ;save handle for later routines z 
mov AX,Driver Buffer Row_Size o 
MOV CX,Num_Pass me 
dec CX w 


D-25 


mul CX 
Mov Row_Stagger, AX 
; check handle 
mov AX, 4400h 
int 21h 
He Ome Ue 
test DL, 80h 
jz IS Allocate 
or DX, 0000000000100000b 
xOr DH, DH 
mov AX, 4401h 
int 21h 
IS_Allocate: 
mov AX, Image _Data_s 
or AX, AX 
jnz IS_DB 
mov BX, Image_Data_Size 
mov CL, 4 
shr BX, CL 
inc BX 
mov AH, 48h 
int ery 
ie IS_ Exit 
mov Image_Data_s,AX 
TS DBI: 
mov AX,Driver Buffer _s 
OG AX, AX 
jnz IS_Exit_OK 
mov BX,Driver Buffer Size 
mov CL, 4 
shr BX,CL 
inc BX 
mov AH, 48h 
int 20h 
jc ES EXit 
mov Driver Buffer _s,AX 
IS Bxit JOKE 
mov AL, 0 
IGS) apes? 


Restore DS 


ret 


@. 0.0 © 6 @ © so sileve suehe te Ss © ‘© le § © je 0's ¢ se 6. (6: 


; Completed Sheet 


Ce 


;row stagger offset 


;get information on handle 
PeeuVabctopan! Crone 

;is handle for a device? 

;if not, skip binary mode set 
;force binary mode 


;set device information 


;if segment <> 0 , do not reallocate 


;Image Data array segment 


;if segment <> 0 , do not reallocate & 


;Driver Buffer array segment 


;return Status=0 


eee ec ee ee 


£ write to HANDLE at the end of the sheet printing 
; free previously allocated memory 
fs pass STATUS back in AL 


eee ee eo ee ee oo ea! a ee: a: ©) te (6! 0) ie) “e” @ 0) "8! (a Vie) Ce" te" fe) ie fe (OS) "ol eh'e 0 9's 0 ee 6 6 6 © 60 © 60 0 © 6 6 6. 6 6 6 © 6 6 » o eee Ie Gen eiene 
BPEOCRCETETEVULE EER ERO EEO EO ERE EEE ERE OCDDD FT OO VOGEL Wel FED ETF CLF, GAMIAEES FFU oT FF C8 0 RRR ree 


Completed_ Sheet: 


Save_DS 

mov AX,Image Data_s ;return Image Data array 

or AX, AX 

nz CS_DB ;if segment value = 0 then do not free 
mov Image _Data_s,0 

mov ES, AX 

mov AH, 49h 

int 21h ;function to free memory 

ae CS_Exit 
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CS_DB: 


mov AX,Driver Buffer_s jreturn Driver Buffer array 
or AX, AX 
3% CS: FE ;if segment value = 0 then do not free 
mov Driver _Buffer_s,0 
mov ES, AX 
mov AH, 49h 
Init 21h ;function to free memory 
a Ke: CS_Exit 
Cop EE: 5 
lea DX,Form_ Feed ;transfer a form feed 
mov BX, Handle 
mov Cx, 1 
call Write 
CS_Exit: 


Restore DS 
ret 


; Page_Break 
; suspend printing on the current page, send form feed, restore printing 
; return STATUS in AL 


OCS ohtz) wi airamiake’ ool lata: al ol 6: SER ESSE S: 'ehle 01'¢, ©) ee \eile’-o\'a is! wlteeiis) .0. 0 is (a (a alia! & (8 18) 0) '8)'@ ysis fe eyede ele etek sts. \o) 88 Oe eS Ree 


Page_ Break: 


Save_DS 

lea DX, Form_Feed ;transfer a form feed 
mov BX, Handle 

mov CX, 

call Write 

Restore DS 

ret 


Mat emutiete cs) o)Taeh. oa 16 SACD es) SY ese]. ee (8 18: 61101 18 0. 2.8 (9) 8) 0! BB) oe) fe. fe. S18) (8,0 ue) eee te Fe 12 8 8) eS Sis iee F. occ e eee ee eee 
CPF FEV CLEP ICL Te: 


Output_Printhead Pass 


; convert the Driver Buffer into a format that the printer will use 
3 remove all trailing zero bytes to reduce print and transfer time 
5 return STATUS in AL 
Pere nie e sists cells) Sip Ad PURE eEL Oy ARE REE ELPA CAEL EL? ht ORENTL Oe TLE CAMP EC OMOD DE CEE LETRA IE OO OEE CER EET UE ES 
Output_Printhead Pass: 
Save_DS 
xor SI,SI ;offset into Driver Buffer 
mov Number _Of Passes, 0 ;reset number of passes 
OPP_Pass: 
mov ES, Image _Data_s ;segment of Image Data array 
xor AX, AX 
mov DI, AX 
mov CX, Image_Data_Size 
cld 
rep stosb ;clear the image data array 


convert the Driver Buffer into the Image Data array 
Driver Buffer is formatted as 24 rows of (max. bits per line / 8) bytes 


e 
, 
: 
, 


push DS 
mov ES, Image _Data_s 
Mov DS,Driver Buffer _s 


assume DS:nothing 


mov CS:Printhead_Line, 0 
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OPP_Loop: 


OPP_Line_ Loop: 


mov 
mov 
shl 
mov 
mov 


lodsb 
or 


Iz 


OPP_Test_80h: 


test 
NZ 
or 


OPP_Test_40h: 


test 


OPP_Test_ 20h: 


test 
jz 
or 


OPP. Test. 10h: 


test 
yz. 
or 


OPP_Test 08h: 


OPP_Test_04h: 


test 
jz 
or 


OPP_Test.02he 


OPP_Next_Byte: 


start 


OPP_@@A: 
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test 


add 
loop 


BX,CS:Printhead_ Line 


AH,CS:Set_Bit [BX] ;which bit to set for this line 
BX, 1 ;convert to word index 
DI,CS:Which_Byte [BX] ;which byte to set for this line 


CX,CS:Driver Buffer Row_Size 


;get byte from Data Buffer 
AL, AL 
OPP_Next_Byte ;if = 0 then skip bit checks 


AL, 80h 
OPP_Test_40h 
byte ptr ES: [DI ],AH ;set bit in Image Data array 


AL, 40h 
OPP_Test_20h 
byte ptr ES: (DI+Bytes Pattern],AH 


AL, 20h 
OPPs Tests20h 
byte ptr ES: [DI+Bytes Pattern*2],AH 


AL,10h 
OPP_Test_08h 
byte ptr ES: [DI+Bytes_ Pattern*3],AH 


AL, 08h 
OPP_Test_04h € 
byte ptr ES: (DI+Bytes Pattern*4],AH 


AL, 04h 
OPP_Test_02h 
byte ptr ES: (DI+Bytes Pattern*5],AH 


AL, 02h 
OPP_Test_0Olh 
byte ptr ES: (DI+Bytes Pattern*6],AH 


AL, Olh 
OPP _Next_Byte 
byte ptr ES: [DI+Bytes Pattern*7],AH 


DI,Bytes_Pattern*8 ;next 8-block 
OPP_Line_ Loop ;continue for all bytes on line 


next line 


add 
mov 
inc 
mov 
mov 
mov 
div 
cmp 
jge 
jmp 


Pop 


SI,CS:Row_ Stagger 

BX,CS:Printhead_ Line 

BX 

CS:Printhead Line, BX ;save net printhead line number 
AX,CS:Printhead_Line Count 

CL,Num_Pass ;divide by 3 

CL 

BX, AX 

OPP_@@A 

OPP_Loop ;Loop for all printhead lines 


DS 


assume 


DS:PRINTER 


; reduce the transfer count to eliminate trailing zeros 


Mov ES,Image Data_s 
mov CX, Image Data_Size 
mov DI, CX 
dec DI 
xor AL, AL 
std 
rep scasb 
; mask to the next whole head pattern 
mov AX, CX 
xor DX,DX 
mov CX,Bytes Pattern 
add AX, CX 
div CX 
mov Printer Count, AX 
mul CX 
Mov Row_Count, AX 
; transfer the graphics row leadin 
lea DX, Printer Code 
mov CX,PC_N 
call Write 
jc OPP_Exit 
; transfer the graphics row 
Mov CX, Row_Count 
push DS 
mov DS, Image Data_s 
assume DS:nothing 
mov Deo 
call Write 
pop DS 
assume DS:PRINTER 
jc OPP_Exit 
; transfer the graphics row end of line 
inc Number Of Passes 
cmp Number Of Passes,Num_ Pass 
jge OPP_Last_EOL 
lea DX, EOL1 
mov CX,EOL1_N 
call Write 
je OPP_Exit 
xor SI,SI 
mov AX,Driver Buffer Row Size 
mov CX,Number Of Passes 
mul CX 
add SI,AX 
jmp OPP _Pass 
OPP_Last_EOL: 
lea DX,End_Of Line 
mov CX,EOL_N 
call Write 
OPP_Exit: 


;segment of Image Data array 


;offset of last element 


;save # head patterns to write 


;save number of bytes to write 


;segment of Image Data 


soffset into Driver Buffer for 


;next printhead pass 


D-29 


> 
Uv 
vU 
m 
= 
o 
QO 
m 
n 


Restore DS 
Zec 
Printer Driver endp 


ec eee eee eee eee ere eer ees er seers eee eee seers er eee eee ere ere ese ee eee eee ee ee eee see eee ee eee 


Dit FPGA LOPE IE EEE OOP PPE FU OK OE AOR I IE EEG RE DOE OEE OF IED EE OP OR WOULD A agrees 


; Write 

; transfer bytes to the HANDLE 

; pass in address of data in DS:DX 
; pass in byte count in CX 

; return STATUS in AL 


oes ee eee eee ee eee eee ee eee see eee eee eee eee eee ee eee ese eee eee reese eeer ses eee ese 


oeecee 
PETE ERERECOE ERODE REOCBDEREERERPERI DRADER EOFEEEDEPECOCEDEFERDIOEVTED EVE DS? OH Wiener pnnee 


Write proc near 


assume DS:nothing 


mov BX,CS:Handle 
jcxz Write Exit 
IFDEF NEC : 
cmp BX, 4 jis the handle the printer? 
je Write PRN ;if yes, jump 
ENDIF 
mov AH, 40h 
push CX ;save count for later check 
int 21h 
pop CX ;recall count 
Ve Write Exit 
cmp AX, CX ;compare written count 
mov AL,E_OK 6 
je Write Exit 
mov AL,E_Disk_ Full ;if written count <> write count 
stc 
Write Exit: 
ret 
IFDEF NEC 
Write PRN: 
push DS 
mov BxX,DS 
mov ES, BX ~ ;address of buffer is ES 
mov BX, DX ;address of buffer is BX 
Mov AH, 30h ;block write 
int 1Ah 
shr AH,1 
shr AH, 1 ;if error, carry is now set 
pop DS 
mov AL,E_Access_ Denied 
j¢ Write Exit 
mov AL,E_OK 
jmp Write Exit 
ENDIF 
Write endp 


Ce 


; DATA AREA 


cece ees eee eee eee eee eee eee eee ee eee ee eee eee eo eo es esre eres ee eeeereres eee sr eee ese see ee ee ee 


FRG E ROE EREO ETE ERRE CR ECE EOEOREDEVETOVERTDEDEEDE FEDER OF TE TERE CUCL OOF FO Pirpneavay) Dime e® 


Handle dw 0 
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Row_Count dw 0 
Printhead Line dw 0 
Driver Buffer _s dw 0 ;segment of buffer to pass bits 
Image Data_s dw 0 *segment of Image Data array 
Row_Stagger dw 0 
Bytes Pattern equ 1 
Num_Pass equ 3 
Form Feed db 0Ch 
EOL1 > Xele QDh, LBh; toy 1 
EOL1_N equ $-EOL1 
End_Of_ Line : db ODh,1Bh,'J',22 
EOL_N equ $-End_Of Line 
Printer Code db Bey oe 
Printer Count dw 0 
PCEN equ $-Printer Code 
Printer Information dw 1920 
dw 3264 
dw 240 
dw 216 
Printhead Line’ Count dw 8*Num_Pass 
dw 0) 
Driver Buffer Size dw ((3264+7) /8) *8*Num_Pass 
Driver Buffer Row Size dw (3264+7) /8 
Image_Data_Size dw 3264*Bytes Pattern 
Set_Bit db 80h, 40h, 20h, 10h, 08h, 04h, 02h, 01h 
Which Byte dw Op WED COR OR OS ORO 
Number Of Passes dw 0 


PRIEPMCLGREN GLP DUALS FLO ETELERGNENS ORUEET TE oe STE Dine Cae e) use AEBS NS PAU ens de au Sinsyd 3)0."o ole eink, Sua yexawene lel ap 0.6 6 ¢ «6 © © Sie 
OTE ENCES LET LE OO ILE IIIND OE BAIR Oa N GONE CMOS Ue MONT BOBCAT ETS AES Ch CH Ee CE 


# the driver can be reduced 
End_Of File Location db 4 


PRINTER ends 
end 


D | 
uv 
vu 
m | 
= 
o 
Q 
m 
n 
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Appendix D Schematic Design Tools 
HOW TO WRITE A PLOTTER DRIVER 


OrCAD provides a number of plotter drivers for use 
with OrCAD products. If you have a plotter not 
supported by an OrCAD driver, you may decide to write 
your own driver. This appendix describes how to do 
that. 


The driver shown here is the generic plotter driver. It 
is supplied by OrCAD, and its filename is 
GENERIC.DRV. The generic plotter driver transfers a 
null-terminated ACSII string to the plotter in place of 
plotter commands. For example, in place of the 
command to draw a line, the driver sends the text 
LINE(. When you write your own plotter driver, you 
would replace that ASCII string with the appropriate 
plotter command. 


A plotter driver is usually written in assembly 
language. It must obey certain conventions as 
described in this appendix. 


D.1 PSEUDO CODE SUMMARY OF A PLOTTER 
DRIVER 


A plotter driver consists of one far procedure called 
Plotter_Driver. The routines within the driver are 
accessed via jmp instructions. The order of the jmp 
instructions is very important. 


For example, the first jmp is to the routine 
Initialize_Driver. When the driver is loaded, the first 
routine in the jmp table is the one that gets executed. 
Consequently, this routine must be Initialize_Driver. 


Here is a pseudo code summary of the generic plotter 


driver. If your plotter doesn't use a particular routine, 
you must still provide the routine. In this case, you 


D-32 


Schematic Design Tools Appendix D 


should "stub" the routine -- that is, turn it into a routine 
that does nothing but return. | 


The convention for plotter routines is that data is passed 
to the routine in BX, and the routine returns status in 
AL. Ifthe data is a structure, a pointer to the structure 
is passed in ES:BX. 


Here is a pseudo code summary of the generic plotter 
driver. 


Macro definitions 
Define Save_DS 
Define Restore_DS 


Error code definitions 
E_OK equ 0 


E_No_More_Files ain 18 
Note that OrCAD defines error code 14, normally 
undefined by DOS. 


Parameter passing structures 
These structures contain data used when plotting a 
certain graphic symbols. For example, the routine 
Plot_Line uses the PL structure. 


STACK segment stack ‘STACK’ 
Defines a stack segment called STACK. This is 
defined as an empty segment. The calling program 
sets up the stack. 


STACK ends 
PLOTTER segment public 'PLOTTER’ 


Defines a public segment called PLOTTER. This is 
the code and data segment for the plotter driver. 
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Plotter_Driver proc far 
List of jmp instructions to the various routines 


Initialize_Driver: 
Performs any needed initialization. This routine is 
executed when the driver is loaded. It may contain 
commands specific to the plotter. 


Initialize_Device: 
Checks the handle. If the handle is zero, the driver 
initializes the serial channel. Otherwise, it uses the 
handle. 


Begin_Plot: 
The generic plotter outputs the ASCII string . 
BEGIN_PLOT(). A specific driver should output 
any commands appropriate to the beginning of the 
sheet. 


End_Plot: 
The generic plotter outputs the ASCII string 
END_PLOT(). A specific driver should output any 
commands appropriate to the end of the sheet. 


Set_Velocity: 
The generic plotter outputs the ASCII string 
VELOCITY(). A specific driver should output any 
commands necessary to change the pen's velocity. 


Set_Acceleration: 
The generic plotter outputs the ASCII string 
ACCELERATION(). A specific driver should output 
any commands necessary to change the pen 
acceleration. 


Set_Force: 
The generic plotter outputs the ASCII string 
FORCK(). A specific driver should output any 
commands necessary to change the pen force. 
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Set_Pen: 
The generic plotter outputs the ASCII string PEN(). 
A specific driver should output any commands 
necessary to select the pen. 


Plot_Line: 
The generic plotter outputs the ASCII string LINE(). 
The routine receives a pointer to the PL structure, 
which defines the line. 


Plot_Circle: 
The generic plotter outputs the ASCII string 
CIRCLE(). The routine receives a pointer to the PC 
structure, which defines the circle. 


Plot_Ellipse: 
The generic plotter outputs the ASCII string 
ELLIPSE(). The routine receives a pointer to the PE 
structure, which defines the ellipse. 


Plot_Arc: 
The generic plotter outputs the ASCII string ARC(). 
The routine receives a pointer to the PA structure, 
which defines the arc. 


Plot_Dashed_Line: 
The generic plotter outputs the ASCII string 
DASHED_LINE(). The routine receives a pointer to 
the PDL structure, which defines the dashed line. 


Piot trext 
The generic plotter outputs the ASCII string 
TEXT(). The routine receives a pointer to the PT 
structure, which contains the position of the text, its 
height, and a pointer to the text itself. 


Poly_Begin: 
The generic plotter outputs the ASCII string 
POLY_BEGIN(). The routine marks the beginning 
of a poly vector stream. Such a stream is defined as 
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one where the pen remains down. For example, the 
lines making up a box belong to a poly vector stream. 


Poly_End: 
The generic plotter outputs the ASCII string 
POLY_END(). The routine marks the end of a poly 
vector stream. 


Output Functions 
These are internal routines used by routines in the 
jmp table, but they don't themselves appear in the 
jump table. 


Data Area 
Reserves space for variables and the driver buffer. 
Also defines variables specific to the plotter. This 
area also contains the variable 
End_Of_File_Location. The routine 
Initialize_Driver uses this variable's location to 
determine the size of the driver so that it can return 
unused memory to the system. 


PLOTTER ends 
end 


D.2 ASSEMBLY AND LINKAGE 


Plotter drivers are intended to be assembled with the 
Microsoft Macro Assembler and linked with Microsoft 
Link. 


For example, consider the generic plotter driver. 
Assume that its source code resides in a file called 
GENERIC.ASM. To assemble GENERIC.ASM, issue 
the following command (on one line): 
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MASM GENERIC /N /T /Z, GENERIC, GENERIC. 
/B68; 


where: 

/N Suppresses tables in listing file. 

re _ Suppresses messages for successful 
assembly. 

/Z Displays error lines on the screen. 

/B63 Changes the size of the file buffer used for 


the source file to 63K. 


The assembly produces two files: GENERIC.OBJ (the 
assembled object code) and GENERIC.LST (the 
assembly list file.) 


To link the file GENERIC.OBJ, enter the following 
command (on one line): 


LINK GENERIC /DOSSEG, GENERIC.DRV, 
GENERIC; 


where: 
/DOSSEG Specifies MS-DOS segment ordering. 


The linkage creates a file called GENERIC.DRV and a 
map file called GENERIC.MAP. GENERIC.DRYV is in 
.EXE format, but is not separately executable. 


An inference rule for a MAKE file that maintains 
plotter drivers is the following: 


.asm.drv: 
MASM $%*/N/T/Z,$*,$*/B63; 
LINK $*/DOSSEG,$*.drv,$*; 


The target/dependent description is as follows: 
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GENERIC.DRV: GENERIC.ASM 


For more information about assembling and linking 


assembly language files, refer to the Microsoft Macro 
Assembler User’s Guide. 
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D.3 SOURCE CODE FOR HP PLOTTER DRIVER 


PAGE 64,132 


NAME HP_Plotter Driver 


ee ey 
CPOE BR LO ORO 8 BF OED. 


+ DECLARATIONS 


Se a ee ee ene at ae See. else) (a) 6) 10) ete) sie). 18 Le: 16 6. @ 18118! 6 8) o. 6) «0's, © (0 .o © 18’ 8 6. She! 6. 5 8) e610 © 0 «0 6 8 
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Save_DS 


MACRO 


push 
push 
pop 
assume 


DS 
Cs 
DS 
DS:PLOTTER 


ENDM 


Restore DS MACRO 


pop 
assume 


DS 
DS:nothing 


ENDM 


7error codes 
E_OK 
E_Invalid_ Function 
E File Not_Found 
E_Path_Not_Found 
E_No_Handles Left 
E_Access_Denied 
E_Invalid_ Handle 
E_Bad_Control_ Block 
E_ Memory Limit 
E_Bad Memory Address 
E_Bad_ Environment 
E_Bad_Format 
E_Bad_Access_ Code 
E_Bad Data 
E_Disk_Full 
E_Bad_ Drive Specified 
E_Current_Dir Remove 
E_Not_Same_ Device 
E_No_ More Files 
*ASCII codes 
Cr 
Lf 


;parameter passing structures 


Parameter struc 
P_Channel dw is 
P_Baud Rate dw @ 
P_Parity db 2 
P_Word Length db ? 
P_Stop Bits db @ 
P_Handle dw ie 
Parameter ends 

BP struc 

BP_X_ Offset dw ty 
BP_Y Offset dw 2 


SUS 2 (9 RE SLs R 6 ies 6: (61S) .e 8) 8) 08) O\ 6 eee We) 6:16 16 66 0: s. 6 & 6 6 6) 6 6 8 6 6 0 6 


;save old DS 


;establish DS addressability 


;restore DS 


equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 


woDMDrIAIaAUNPWNEH CO 


equ 
equ 


Fi bere PZ 
Rabe, SSO}. 
70 (none), 
dlr, as) 
aby. 


300, 600, 
1 (odd), 2 


1200, 2400, 
(even) 


4800, 9600 


BP ends 
PL struc ;Plot_Line parameters structure 
PL Xs dw a 
PL Ys dw ? 
PL Xe dw % 
Pimve dw é 
PL ends 
PE Struc ;Plot_Ellipse parameters structure 
PE_Xc dw ? 
EERYC dw ig 
PE Xr dw fs 
PE Yr dw ? 
PE ends 
Xe struc ;Plot_Circle parameters structure 
PGEX dw 2 
Jey Ne dw 2 
PC_Radius dw ? 
PC ends 
PA struc ;Plot_Arc parameters structure 
PA_Xc dw ? 
PASC dw 4 
PA Xel dw & 
PA Yel dw GZ io 
PA Xe2 dw a 
PARYe2 dw 2 
PA Radius dw & 
PA ends 
PDL struc ;Plot_Dashed_Line parameters structure 
PDL _ Xs dw ? 
PDL Ys dw fi 
PDL Xe dw % 
PDL Ye dw ? 
PDL ends 
Jeb struc ;Plot_Text parameter structure 
PT X dw ? 
Eek dw ce 
PT Height dw & 
PT String _p dd % 
PT ends 
STACK segment stack 'STACK' 
STACK ends 
PLOTTER segment public 'PLOTTER' 
assume CS:PLOTTER 
assume DS:nothing 
; Plotter Driver 
; interface to Plotter driver is made with a series of far calls 
; all parameters are passed via registers, the specific registers are 
; detailed for the sub-command re 


SEE REA Psat een ae ee ae te) Ree. 6) Oe Se) 6 elie ee) 8) rel 16 813) b ie we ye ye Lae AOke gee Ks Ne onde) Ke. (eGo Werte fe le Te. 40 Tete. te. Ge fei "e "eee. © 6:.@ « @ e's oe 'e 


Ce OO NIE ROO RR RO RE Bk ee BE eB 2 Be CPOE AEE EER OR OREO ER EEE OPO ROE CLE EDOL ELLE ST 


Plotter Driver proc FAR 


jmp Initialize Driver 
jmp Initialize Device 
jmp Begin Plot 

jmp End_Plot 

jmp Set_Velocity 

jmp Set_Acceleration 
jmp Set_Force 

jmp Set_Pen 

jmp Plot_Line 

jmp PlotsCircle 

jmp Plot_Ellipse 

jmp PLOtCmARC 

jmp Plot_Dashed_Line 
jmp Plot Text 

jmp Poly Begin 

jmp Poly End 


Sign_On Message db 'HP Plotter Driver V3.00',0Dh,0Ah,'$! 
COPYRIGHT_NOTICE db '(C) Copyright 1987 OrCAD Systems Corporation' 


db ' ALL RIGHTS RESERVED.','S$' 
DECC E POPB BELPER OGBR BPRAGO ROR ERIE DEE OF BOE Ok BURR 8 uO FY OT ACRE EE ae ae ear ane ane 
; Initialize Driver: 
; sign on 
; set Ctrl-Break check to TRUE 
; shrink the required memory 


5 return STATUS in AL 


See Pen Ci Een ene. (0) Sra hae ie: 18) 8101'S 1a) 168, ee ele! (eee 6 6 8. 6 See) ome eees OS) eheuke yokete =e .« 0.0) 6, sale 6 ¢ 00:0 0 @ @ @:6 0 6.6 6 6 6-06 6 


Initialize Driver: 


Save _DS 
; display the program title, revision and copyright notice 
mov Dx, offset (Sign_On_ Message) 
mov AH, 09h 
int 21h ;print Sign_On_Message 
mov DX, offset (COPYRIGHT NOTICE) 
mov AH,09h 
int 21h sprint Copyright_Notice 
; set Control-Break checking in DOS to TRUE 
mov AH, 33h 
mov AL, 1 
mov DL, 
int 21h 
; return unused memory to the pool 
mov AX,CS ;segment address of this overlay 
mov ES,AX ;recall segment address 
mov BX, offset (End_Of File Location) 
mov CL, 4 
shr BX, CL 
add BxXae 
mov AH, 4Ah ;modify allocated memory blocks 
int 21h 
Restore DS 
ret 


3 SP3P<><><2< 25 >< >< ><><><6><5><><<< PLOTTER ROUTINES >>><><><><><><><><><><><><><> 
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; Initialize Device: 
; initialize the device 
; if the handle is <> 0 then write only to the handle 


5 if the handle = 


hy Te tee rer tac 


2 2 2.0 © 8 0 8 8 om Se 6 Ce & 0) 6 inl 1a) oF 6) @) 6 6) 0) ©! 6 16 8 0) 6) ue) 


0 then initialize the serial channel 


; pass in via ES:BX a pointer to the PARAMETER structure 
; return STATUS in AL 


he 6 6) 4) oe (6 6.0 = eelmhens 


CLE PR TIE Oe Da EARP, 


cece eee eee eee es 


GO POOL ONE PE ONE 


Initialize Device: 


Save _ DS 
xOr 
mov 
mov 


Nz 
jmp 
ID Serial: 
mov 
dec 
mov 
xor 
mov 
cmp 
je 
add 
cmp 
je 
add 
cmp 
je 
add 
cmp 
je 
add 
cmp 
je 
add 
cmp 
je 
add 
cmp 
je 
add 
cmp 
jne 
Found Baud Rate: 
mov 
cmp 
je 
add 
cmp 
je 
add 
cmp 
jne 
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AX, AX 

Buffer Count, AX 
Last_Pen, AX 
Last_Velocity,AxX 
AX, ES: [BX] .P_Handle 
Handle, AX 

AX, AX 

ID_ Serial 

ID_Handle 


AX, ES: [BX] .P_Channel 
AX 

Channel, Ax 

AL, AL 
CX,ES: [BX] .P_Baud_Rate 
CxX,110 

Found Baud Rate 
AL, 00100000b 
CX,150 

Found _Baud_ Rate 
AL, 00100000b 
CX, 300 

Found Baud Rate 
AL, 00100000b 
CX, 600 

Found Baud Rate 
AL, 00100000b 
CxX,1200 
Found_Baud_ Rate 
AL, 00100000b 
CX, 2400 

Found Baud Rate 
AL, 00100000b 
CX, 4800 

Found Baud Rate 
AL, 00100000b 
CX, 9600 
ID_Error Exit 


CL,ES: [BX] .P_Parity 
CL,0 

Found Parity 

AL, 00001000b 

CL,1 

Found Parity 

AL, 00010000b 

CL,2 

ID Error Exit 


oie) |B) e's! 8] 1) © et lee: 0 0 0 2 2 eles) 6 0 0.0 6 0.0 3 6 6 6) eka: se eiareneee 


;clear Buffer Count 
;clear Last_Pen 
;clear Last Velocity 


;convert the channel from 1..2 to 0..1 


7Set up AL to reflect the baud rate 


sif not found, exit without changing port 


;set up AL to reflect the parity 


7if not found, exit without changing Pe 


Found Parity: 


mov CL,ES:[BX].P_Stop Bits ;set up AL to reflect the Stop bits 

cmp CLAL 

je Found Stop Bits 

add AL,00000100b 

cmp CL,2 

jne ID Error Exit 7if not found, exit without changing port 
Found Stop Bits: 

add AL, 00000010b 7set up AL to reflect the word length 

mov CL, ES: [BX] .P_Word_ Length 

cmp Ch 

je Found Word Length 

add AL, 00000001b 

cmp CES 

jne ID_Error Exit ;if not found, exit without changing port 
Found Word Length: 

mov DX, Channel 

cmp DxX,0 

je Found_Channel 

cmp Dp, Fal 

jne ID_ Error Exit sif not found, exit without changing port 
Found Channel: 

mov AH, 0 ;initialize function 

int 14h ;bios com interrupt 
ID_ Handle: 

mov AL,E_OK Since not serial return E_OK 

mov SI,offset (INITPLOTTER) 

call Put_ Output 

Restore DS 

EEG 
ID_Error Exit: ;return error code 

mov AL,E_ Bad Environment 

Restore DS 

rec 
ELUTE DEMO RS CTO ESTO, CR ERTL CT TAR SEREEECER EELS RRLLERERERERRIRERA ETD Eire 
; Begin Plot: 
; called at the beginning of the plot of the current sheet 
; x_offset, y offset are pointed to by a pointer passed in ESBX 


return STATUS in AL 


APL OL Dh SENET TRENCH ER TMAN GRO ET are Rate a eT on chet shel e} e¥ oh el aFie) chia! of at Mater ef slvelisiic’ Shekelleke slelsle Glotel ele od eheliec Stee of tems: ote 
een iat LOO ORCL CIRPE LACM ROMILEMORVAILS DIS OM P RDI. EC C28! BUENEMEM) NIN TG PRORERT OL CURINGR GEE KE ONG De Sr Oe 


Begin Plot: 
Save_DS 
mov AX, ES: [BX] .BP_X Offset 
call Make Plotter Units 
mov X_Offset, Ax 
mov AX, ES: [BX] .BP_Y Offset 
call Make Plotter Units 
Mov Y_Offset, AX 
mov Current_X, OFFFFh ;initialize Current_xX 
mov Current_Y, OFFFFh sinitialize Current_yY 
mov SI,offset (BEGINPLOT) 
call Put_Output 
Restore DS 
rec 
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; BndePlot: 
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called at the end of the plot of the current sheet 


in AL 


return STATUS 


the end of the sheet 


this? is 


7Since 


put 


SI,offset (ENDPLOT) 
Put Out 
Flush Buffer 


CP Exit 


: 


jc 


Save DS 
mov 
call 
call 


End Plot 


CP Bxit 


Restore DS 


ret 


ty 
set the plotter current pen to the velocity passed in BX 


Set_Veloci 


ors 


in AL 


return STATUS 


coe ee ee eee sere 
Che A CDT let Bal MINT Oo Cart I 


es 


° 
, 


et Veloci 


eee eee 
PE ORE EE 


° 
, 


ty 
Save DS 


S 


last velocity ? 


no change neccessary 
save new velocity 


new velocity 


yes, 
no, 


. 
, 


ity 


Velocity Unchanged 


BX, Last Veloc 


cmp 


, 


je 
mov 
mov 


Last Veloci 


, 


ty, BX 
SI, offset (SETVELOCITY) 


Put Out 


call 


put 
SVEELrEOr bc 


ac 
mov 


AX, Last Veloc 


ity 


Put Word 


call 


SV Error Exit 


iC 


Put TERM 


call 
Velocity Unchanged 


. 
. 


SV_Error Exit 


Restore DS 


ret 


° 
. 


set the plotter current pen to the Acceleration passed in BX 


Set_Acceleration 


en es 


in AL 


return STATUS 


Set Acceleration 


ret 


. 


set the plotter current pen to the Force passed in BX 


return STATUS in AL 


Set_Force 


Set Force 


ret 
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7 
n 


e 
set the plotter current pen to the Pen passed in BX 


return STATUS in AL 


ce ee 
sree 
Cae 


cee 
rae 


Cr. ar 


os 


. 


Set Pen 


Save DS 
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cmp BX, Last _Pen ;new Pen = last Pen ?° 


je Pen Unchanged ;yes, no change neccessary 
mov Last_Pen, BX *no, Save new Pen 

mov SI,offset (SETPEN) 

call Put Output 

je SP_Error Exit 

MOv AX, Last_Pen 

Cad Put_Word 

IC SP_Error Exit 

call Put_TERM 


Pen Unchanged: 
SP_Error Exit: 
Restore DS 


Seu 
; Plot_Line: 
; plot a line 
; Xs,Ys,Xe,Ye are pointed to by a pointer passed in ES:BX 
; | xeturn STATUS in AL 
Plot_Line: 
Save_DS 
mov word ptr Current _Pointer[0],Bx 
mov word ptr Current _Pointer[2],ES 
mov CX,ES:(BX].PL Xs 
mov DX,ES: (BX].PL_Ys 
call Compare XY 
test AL, 1 WStLAaTcIinGgu(xXS, Ss) =) current (X,Y)! 2 
jnz PL Put _PenDown ;yes, put pen down to draw line 
call Put_PENUP selse raise pen up to starting (Xs,Ys) 
je PL Error Exit 
les BX,Current_ Pointer 
mov CX,ES: [BX] .PL_ Xs 
mov DX, ES: [BX] .PL_Ys 
call Put_XY 
3¢ PL Error Exit 
call Put_TERM 
ae PL Error Exit 
PL Put_PenDown: 
call Put_PENDOWN ;put pen down and draw line to (Xe, Ye) 
ake PL Error Exit 
PL_To_ XY: 
les BX, Current_Pointer 
mov CX, ES: [BX] .PL_Xe 
mov DX,ES: [BX] .PL_Ye 
mov Current_X,CX supdate Current (X,Y) 
mov Current_Y,DX 
call EAL Oe 
HE PLUErrOL BxLt 
test Poly Flag,1 icheck if plotting polygon occurs? 
jnz PL Exit ;yes, exit 
call Put_TERM 
ake: PL Error Exit 
call Put_PENUP ;no, raise pen up 
3c PL° Error Exit 
PL Exit: 
call Put_TERM 
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PORE rota ited 


Restore DS 


ret 


ed 


; Plot_Circle: 


@ ‘Bile, 01 "a aie (et evse! eva 56: elm fe) elielel is; 6 18 


©, [6 6 6) 9.'@ 0», eliw-s,/@ 16118) (8) 8) os) 2) a) 


ee ey 


; plot a Circle 
7 X,Y,Radius are pointed to by a pointer passed in ES:BX 
; return STATUS in AL 


ee ray 


Plot Circle: 


Bt 8) O06) Oy SB, 19) ©) '8 eee oe) ‘ef Biel ie\ ie) a) 1s, Sie) ae elle! @ caver eS a le pee uel Oe wise; enlelia Caliah enneits 


jraise pen up to center 


;update current 


(X, Y) 


;issue a circle command 


;specify the radius 


;specify chord angle based on radius 


;raise the pen up 


Save_DS 
mov word ptr Current _Pointer[0],BX 
mov word ptr Current _Pointer[2],ES 
call Put_PENUP 
je PLSrr Omens 
les BX,Current Pointer 
mov CX,ES: [BX] .PC_X 
mov DX,ES: [BX] .PC_Y 
mov CuETenEmwiGx 
mov Current Y,DX 
call Put_XY 
je PL Error Exit 
cox Bal Put_TERM 
jc PL_Error Exit 
mov SI,offset (CIRCLE) 
call Put Output 
je P€_Error Exit 
les BX,Current_ Pointer 
mov AX, ES: [BX] .PC_Radius 
call Make Plotter Units 
call Put_Word 
jc PC_ Error Exit 
les BX,Current_Pointer 
mov AX, ES: [BX] .PC_Radius 
call Put_CHORD_ANGLE 
je PCRETTCOr mrss 
call Put_TERM 
je PC_Error Exit 
call Put_PENUP 
7 PC Error Exit 
call Put_TERM 
PC_Error Exit: 
Restore DS 


ret 


oe 
CLO OE ECE OEE O88 


; Plot_Ellipse: 
; plot a Ellipse 
; return STATUS in AL 
Plot Ellipse: 
Bec 


; Plot Arc: 


plot a Arc 


be: Oe @ lel ele) een e 


eee eco e ce ee 
OOOO REO OE ASE OE IA LTE BEL EO O COLE A, PPE OE LE PESO PAP PUR PRUE 


coe eee 


ce ee 


Xc,Yc,Xr,Yr are pointed to by a pointer passed in ES:BX 


cee eee 


(X, Y) 


cece eee 16 6.6 
FOO OE DO Pana 


eee ee eee 


oe 
F Rate Poe 


ale fete (ea As we Ue Te 1S e 5-8) Se, 6 |e 0. 0 ee 6 6 es le @ 46 © a 6 eb ome (6s :4 


Xc, Yc, Xel, Yel, Xe2,Ye2,Radius are referenced the pointer passed in ES:BX 
return STATUS in AL 


Plot Arc’ 


PA_EE: 


Save_DS 
mov 
mov 
mov 
mov 
call 
test 
spol. 
call 
aK 
les 
mov 
mov 
call 


ae 
call 
jc 


PA_Put_PenDown: 


call 
jc 
call 
ae! 


PA_Draw_ Arc: 


mov 
call 
Ie 
les 
mov 
mov 
call 
ae 
call 
nC 
call 
or 
jns 
mov 
neg 


PA Continue: 


PA_Exit: 


call 
ae 
les 
mov 
call 
IC 
test 
jnz 
call 
jc 
call 
ae: 


call 


Sie Ore aie ten Bie! (e616: ©) es. ee) eis) is 6 6. 6.6) 6) e! © & 6) 0) 6:6, 6 ein) 6 


word ptr Current _Pointer[0],BX 
word ptr Current Pointer(2],ES 


CX, ES: [BX] .PA_Xel 
DX, ES: [BX] .PA_Yel 
Compare XY 

AL, 1 

PA Put _PenDown 
Put_PENUP 

PA_EE 

BX, Current _Pointer 
CX, ES: [BX] .PA_Xel 
DX, ES: [BX] .PA_Yel 
Put_XY 


PA Error Exit 
Put_TERM 
PASE TrOrs Ext 


Put_PENDOWN 
PA Error Exit 
Put_TERM 

PARE LCOne ext 


SI, offset (ARC) 
Put_Output 

PA Error Exit 
BX, Current _Pointer 
CX, ES: [BX] .PA_Xc 
DX, ES: [BX] .PA_Yc 
Put_XY 
PARE TCO Limbscit 
Put_COMMA 

PA _ Error Exit 
Find _Arc_ Angle 
AX, AX 

PA Continue 
Negative Flag,1 
AX 


Put_Word 

PA_ Error Exit 
BX,Current_Pointer 
AX, ES: [BX] .PA_Radius 
put_CHORD_ANGLE 

PA Error Exit 

Poly Flag,1 
PA_Exit 

Put_TERM 

PA_Error Exit 
Put_PENUP 

PA _ Error Exit 


Put_TERM 


;Starting (Xel,Yel) = current (X,Y)? 
;yes, put pen down and draw an arc 
;raise pen up to (Xel, Yel) 


;put pen down 


;issue an arc command 


;specify center point 


;find an angle/direction of an arc 
;check if clock wise (-) 

jjump if counter clock wise (+) 
;clock wise set Negative Flag true 
;take absolute angle 


;specify chord angle based on radius 


;check if plotting polygon occurs? 
syes, exit 


;no, raise pen up 
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les BX, Current _Pointer 

mov CX, ES: [BX] .PA_Xe2 

mov DX, ES: [BX] .PA_Ye2 

mov Current _X,CX update current 7(xX, Y) 
mov Current_Y,DX 


PAPEDroOre Exits 
Restore DS 
ret 


j Plot_Dashed_Line: 
; plot a Dashed_Line 


Xs,Ys,Xe,Ye are pointed to by a pointer passed in ES:BX 
' return STATUS in AL 
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Plot_Dashed_Line: 


Save _ DS 

mov word ptr Current_Pointer[0],BxX 

mov word ptr Current_Pointer[2],ES 

mov SI,offset(SETDASHLINE) ;specify dashline pattern 
call Put_Output 

jc PDL Error Exit 

call Put_PENUP ;xaise pen up to (Xs, Ys) 
ae PDL Exror! Exit 

les BX, Current Pointer 

mov CX,ES: [BX] .PDL_Xs 

mov DX,ES: [BX] .PDL_Ys 

call Put_XY cd 
aK) PDL Error Exit 

call Put_TERM 

je PDL Error Exit 

call Put_PENDOWN ;let pen down and trace a dashed line 
ale PDL Error Exit 

les BX, Current_Pointer 

mov CX,ES: [BX] .PDL_ Xe 

mov DX, ES: [BX] .PDL_ Ye 

mov Current X,CX ;update current (X,Y) 
mov Current_Y,DxX 

call Put xy 

je PDL Error Exit 

cai Put_TERM 

jc PDL Error Exit 

mov SI,offset (RESETDASHLINE) ;set back to solid line 
call Put_Output 

ake: PDL_ Error Exit 

call Put_TERM 

jc PDL Error Exit 

call Put_PENUP ;raise pen up after all 
je PDL Error Exit 

call Put_TERM 


PDL Error Exit: 
Restore DS 
ret 


; PLlotelext: 
; plot a Text string 
; String _p,X,Y,Height are pointed to by a pointer passed in ES:BX e 


: return STATUS in AL 


O16 50: 0.58 A 9) OO enone os Tepes ieke = we 2 tel 6ueee tells: Keira ne 


pag NOTEQS 
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; On the HP plotter, the character-to-character space is 3/2 the width. 
f The plotting routine expects the character-to-character space to be 


5 equal to 4/3 the height passed in. The width is therefore equal to 
; (4/3) *(2/3) the height (8/9). 
PLOtmrexti: 
Save_DS 
mov word ptr Current _Pointer[0],BX 
mov word ptr Current _Pointer(2],ES 
# calculate character width and height in centimeter (lin = 2.54cm) 
mov SI,offset (SETCHARSIZE) ;issue set character size command 
call Put_Output 
jnc PT_ Continue 
jmp PTSELrOn Exit 
PT Continue: 
les BX,Current_Pointer 
mov AX, ES: [BX] .PT_ Height ;calculate character width 
xor DX, DX ; (Height *8/9) *2.540 
mov CX,254*8 
mul CX 
mov CX, 100*9 
div CX 
call Put_Fixed 
ake: JeMW Napereolea Japrako 
call Put_COMMA 
je JEM _JOpeieo pea JOpraalte 
les BX,Current_Pointer 
mov AX, ES: [BX] .PT_Height ;calculate character height 
xor DX, DX ;Height*2.54 
mov CX,254 
mul CX 
mov CX, 100 
div CX 
call Put_Fixed 
ae PRObrcor exit 
call Put_TERM 
je PT Error Exit 
* move the pen to where the text should be at 
call Put_PENUP jraise pen up to (X,Y) 
jc PT Error Exit 
les BX, Current _Pointer 
mov CX,ES: (BX] .PT_X 
mov DAVES BMI Pile Y. 
mov Current_X,CX ;update current (X,Y) 
mov Current_Y,DxX 
call BPUeexy, 
je PT Error Exit 
call Put_TERM 
ake PT Error Exit 
mov SI,offset (LABEL) ;issue label command 
call Put_ Output 
je PPVError Exit 
;convert the string to the string ended with ETX and NULL 
les BX,Current_Pointer 
push DS ;save DS 
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push DS 
lds SDPES CBS) er oorangep) =i, DSS i) point oO seming 
pop ES 
mov DI,offset (Text) ;make ES:DI point to text buffer 
lodsb ;get string count 
xOr AH, AH ;convert to word 
mov CX, AX ;use as move count 
cld 
rep movsb 
mov AL, 03h 
stosb ;insert a ETX character 
xor AL, AL 
stosb ;make last byte a null 
pop DS ;restore DS 
MOv SI,offset (Text) 
call Put_Output peranster elaine 
je PISE ero rena 
call Put_PENUP ;raise pen up after all 
ie IY jopapetoa jd .ake 
call Put_TERM 
PT _ETroOrabxies 
Restore DS 
ret 


er 


CE ERERECETEDETCEOEELEEEAGDILDEL EDA REROREEECEEECEREEPVEDPAEPDPEEUPEPUPIEN F069 F CAV LEIrEs rebar 


; Poly Begin: 


; mark the beginning of a poly vector stream y 
; pass back STATUS in AL g 
a a ere a ae ea ee a Tes hr ee CO RMON: CLONAL PEO OLOMOUC UO ROD eee & 
Poly Begin: 

Save DS 

mov Poly. Flag, 1 ;set Poly Flag on 

Restore DS 

mov AL, E_OK 

Dee 


coe ee eee eee eee eee eee reese eres eee eee eerseerseer eer eroeerer rere ereerereere reese eee se 


° ee 

CEEERECPEEEPESECED ODED OEETESPEEEECEEED DEEP UT EP PINE LE RAELELE ELELEMPETD FE ED PER Rep ERE 
° 

, 


Poly End: 

; mark the end of a poly vector stream 

; pass back STATUS +n AL 

Poly End: 
Save DS 
mov Poly Flag,0 ;reset Poly Flag 
call Put_PENUP ;raise the pen up 
aC PEnd Error Exit 
call Put_TERM 


PEnd Error Exit: 
Restore DS 
ret 

Plotter Driver endp 


3 SP3<PK<OKO RO ROK LOK OK OK OK OK O><<<_ OUTPUT FUNCTIONS >>><><><><><><><><><><><><><><> 


assume DS:PLOTTER 
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; Put_Output: 


; sent the null terminated ASCII stream to the output device 


; return the STATUS in AL, 


if <> E_OK then set the carry flag 


Siew: 6 6) #18). 1@6) @ 9) @ © 6 61s OFS) @ © 5 © 6 2 ) @ ee 8 6 © 8 6 BO © Sie 6 12 SEES Sue 000 (8 » © 9 6 tidumive (0, 6 6 © 6 6 6 6 0 0 00 & 4 6 0 e808 6 © 
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Put_Output proc near 


Get_Character: 
lodsb 
mov 
or 
jnz 
Suc 
Bec 


Send_Character: 


Character, AL 
AL, AL 
Send_Character 


;get character from DS:SI 
;save character 


; check STDIN so that DOS will stop program if Control-Break is typed 


mov 
int 
cmp 
jne 
mov 
mov 
int 
test 
jz 
mov 
mov 
Mov 
int 
test 
MZ, 
jmp 


Not_COM Port: 
mov 
cmp 
jne 
Cal 
jnec 
EEG 

Put_Character: 
mov 
mov 
Mov 
inc 
mov 
jmp 

Put Output endp 


ed 


AH, OBh 

21h 

Handle, 0 
Not_COM Port 
DX, Channel 
AH, 3 

14h 

AL, 10h 
Send_Character 
AL,Character 
DX, Channel 
AH, 1 

14h 

AH, 80h 
Send_Character 
Get_Character 


CX, Buffer Count 
CX, Buffer Size 
Put Character 
Flush_Buffer 
Putecharacter 


AL, Character 
BX, Buffer Count 
Buffer [(BX],AL 
BX 

Buffer Count, BX 
Get_ Character 


; Flush_Buffer: 
; send the entire buffer to the handle 
; return the STATUS in AL with carry set if STATUS <> E_OK 


am Bie 10\0@) (0) (wie e).6 6 2 5 9 le 6 & © © 6 6, 8.6) 6 @ 0 910) 9 6 (6 (e 6: '6 © 0: (6 0 5) (9 (81 9: 6 6. Sigere seKe 


Flush_Buffer 
mov 
mov 
mov 
mov 


proc near 
BX, Handle 
CX, Buffer Count 


DX, offset (Buffer) 


AH, 40h 


;Check Standard Input Status 


;check Handle 

;if handle <> 0 then output via DOS 
;get current channel 

;COM PORT STATUS 

;bios com interrupt 

;is CLEAR TO SEND set 

PLLA not, «= OOD 

;recall character to send 

;get current channel 

;COM SEND CHARACTER 

;bios com interrupt 

;was character send 

ftimesiouty, SO retry. 

;character was sent, so do next 


;£irst check if othe buffer is full 
7;get current buffer load count 
;compare to the max buffer size 
joes Duties 15 nmotmtull, jump 

;else flush the buffer 

;if there was no error, continue 


;get current character 
;get Buffer last load point 
;save the character in the buffer 


;save the new last loaded point 
;get next character 


eee eee eee eee oe eee eee es eo @ 


ecco eee eee eee eee eee eee eee eee 


;destination of write 
;how much to write 
;source of write 
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int 21h ;write 
3¢ Flush_Buffer Exit ;if error, exit now 
;check if the write count matches the written count 
cmp AX, Buffer Count 
Mov AL, E_OK 
je Flush Buffer Exit ;if counts match, then E_OK 
mov AL,E Disk Full 7else the disk is full 
stc ;set the carry flag to indicate error 
Flush_Buffer Exit: 
mov Buffer Count, 0 ,resee Burter: Count 
ret 
Flush_ Buffer endp 
; Put_Fixed: 


; enter with AX holding a fixed place word 

; convert the fixed place word to an ASCII text stream-> XX.XXX 
; send the text stream to the output 

; return the STATUS in AL with the carry set if <> E_OK 

Put Fixed proc near 
;clear ASCII_FIXED 


push AX ;save AX 
elle 
mov DI,offset ASCII_FIXED 
mov XPT 
xor AX, AX 
rep stosb v 
pop AX ;recall AX 
xor BX, BX 
cmp Ax,9999 
jle PF_Thousands 
xor DX,DX 
mov Cx, 10000 
div CX 
xchg AX,DX 
add Dis ne0s 
mov ASCII_FIXED[(BX],DL 
inc BX 
PF_Thousands: 
xor DxX,DX 
mov CX, 1000 
div CX 
xchg AX,DX 
add DEAL 
mov ASCII_FIXED[(BX],DL 
inc BX 
mov ASCLILUPIXED (BX), va! 
inc BX 
xor DX,DX 
mov Cx, 100 
div CX 
xchg AX, DX 
add Dis, 710)! 
mov ASCII_FIXED[(BX],DL 
ince BX 
or AX, AX 
jz PF Null v 


D-52 


xor DX,DX 


mov CX, 10 
div CX 
xchg AX, DX 
add Dio 
mov ASCII_FIXED[BX],DL 
inc BX 
or AX, AX 
ik PF_Null 
add Ai, ‘0! 
mov ASCII_FIXED[BX],AL 
LNCS BX 
PF_Null: 
mov ASCII_FIXED [BX], 0 
mov SI,offset (ASCII FIXED) 
call Put_Output 
ret 


Put Fixed  endp 


eee eee ee ee ee eee eee eee eer eee eee e ore reer eee eee e eee eee eee reese eeeees ere eee ee eereeees 


CeCe Ee Pat ee RW eh oe ee LPS POE Oe RE POP ee RO OOF OER CR ReR OO Fe FOE OOO EE OO ET EL EERE FE 


; Put_Word: 
; enter with AX holding a Word 
; convert the word to an ASCII text stream-> XXXXX 
; if Negative Flag on then add minus sign to text stream : -XXXXX 
; send the text stream to the output 
; return the STATUS in AL with the carry set if <> E_OK 
Put_Word proc near 
;clear ASCII_WORD 
push AX ;save AX 
cld 
Mov DI,offset ASCII WORD 
mov CX, 6 
xor AX, AX 
rep stosb 
pop AX ;recall AX 
xor BX, BX 
cmp AX, 9 
jle PW_Units 
cmp AX, 99 
jle PW_Tens 
cmp AX, 999 
jle PW_Hundreds 
cmp AX, 9999 
jle PW_Thousands 
xor DX, DX 
mov Cx, 10000 
div CX 
xchg AX, DX 
add Dina 
mov ASCII_Word[BX],DL 
inc BX 
PW_Thousands: 
xOr DX,DX 
mov CX, 1000 
div CX 
xchg AX, DX 
add DL, '0' 
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mov 
inc 
PW_Hundreds: 
xor 
mov 
div 
xchg 
add 
mov 
inc 
PW_Tens: 
xor 
mov 
div 
xchg 
add 
mov 
inc 
PW Units: 
add 
mov 
inc 
mov 
mov 
test 
Biz 
mov 
dec 
PW_Exit: 
call 
Zee 
Put_Word 


oe tee 8 (6) Opie e 6 a) 6's & 


; ISehes 2.048 


ASCII_Word [BX], DL 


BX 


DX,DX 
Cx, 100 
CX 

AX, DX 
DL, "0: 


ASCII_Word(BX],DL 


BX 


DX, DX 
CXPLO 
CX 

AX, DX 
Duo" 


ASCII_Word[BX],DL 


BX 


AL, '0' 


ASCII_Word [BX], AL 


BX 


ASCII_Word [Bx], 0 
SI, offset (ASCII_Word) 
Negative Flag,1 


PW_Exit 


Negative Flag,0 


SI 


Put_Output 


re  eD 


o fel 0) | ie ie 0 ie) ve © s. ‘els: 916 6 ei whine) eee) oe 6) 6.4) 


; enter with CX holding X value, DX holding Y value 
; convert to ASCII text streams and send to the output device 
; return the STATUS in AL with carry set if STATUS <> E_OK 


a) a, oe 6 6, elie te''e' 0 6 e's @ 


LEME UE EEG EGE OEE OD ERO EERO OTE EE ET ER OC CREOLE ECT UE Tat DP LOD EOD OBER UE BUS ere eae 


coe eee ee eee ee 


Put XY proc near 


push 
mov 
call 
add 
call 
AC 
cad. 
aie 
pop 
call 
add 
call 
qbhe 2.06 Japmalie 
ret 
Put XY 


occ eee ee oe ee woe 


DX 
AX, CX 
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;save Y in stack 


Make Plotter Units 


AX, X_Offset 
Put Word 
ble. 2.6 Jareabis 
Put_COMMA 
PULBXYSE x2 
AX 


;offset space of space plot 


7 reCalleey. 


Make Plotter Units 


AX, Y_Offset 
Put _Word 


o 1G) 6 19) 16 6 0 0 is ‘We 6 oe 6. 0 6 © 6 6 © fe 


; Makes PlottersUnits): 
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;offset space of space plot 


ee D 


. 


. 
, 


#= (#*10000) /9800 


. 
, 


(.00098"/unit) 


resolution 


OOH 


in 


proc near 
Cx, 10000 


CX 


9800 
-endp 


CX, 
CX 


return with AX in plotter units 


enter with AX 
convert to plotter units 


mov 
mul 
mov 
div 
ret 
Make Plotter Units 


Make Plotter Units 


APPENDICES 
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y speed 

yy a 

y _ 

; : - 
terminator character 


; 
issue pen down command 
; 


. 

, 
. 

, 
. 


issue pen up command 
; 


; 
71issue a 
; 


, 
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, 
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’ 
. 
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£f <> E OK then set the carr 
issue a comma 
£ <> E_OK then set the carr 


if <> E OK then set the carr 
if <> E OK then set the carr 


oe ores os On os rs Ors ed oiow Pes 
“3 ax ne ox rr xe On oe 
ea te a my Se en eee ae Kaos oe 
fe: ars on ets on rm Jeers on Hon os 
r- s oss s rr on Ges on 
os. os on. on ay os 
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it 
i 
Hs 
; 

. 


. 
. 
. 
. 

, 
. 


put 


SI, offset (PENDOWN) 


SI,offset (PENUP) 
put 
Put Out 


Put Out 
SI,offset (COMMA) 
put 


Put Out 
SI,offset (TERM) 


Put Out 


° 

, 
. 
. 


endp 


. 
. 
° 
, 
° 
, 
° 
° 


proc near 
endp 
; 
; 
proc near 
endp 
; 
; 
proc near 


send a PENDOWN command to the output device 
endp 


send a PENUP command to the output device 


put 
send a COMMA to the ouptut device 


return the STATUS 
return the STATUS 
proc near 
return the STATUS 
send a semicolon 
return the STATUS 


Put PENUP 
mov 
cali 
ret 

Put PENDOWN 
mov 
call 
ret 

Put PENDOWN 

Put COMMA 
mov 
call 
ret 
mov 
call 
ret 


eeu te ew ow Ce. aT a Ya ro a a a. a re ra a ars 


Put _PENDOWN 


~~ Qu ow oe ow os os . 
| ae 5 os | re os | ou & : os. | re on 
= B SS = y aa 
~ (J ~ on es ~O (e) os * ft) os 
~ Ay oN os. oN ~ O Cc on eo. H & on 
tad Pees ~ | — Sag) foes | fon 
LD yp v v y v 
=) 3 fe] f=] =] 3 
Oy Oy fer) Ay Ou A 
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;  Put_CHORD_ANGLE: 


; enter with the radius in AX 
; send the chord angle portion of the command to the output 
; return the STATUS in AL, if <> E_OK then set the carry flag 
Put_CHORD_ANGLE proc near 

mov SI,offset (CHORD ANGLE) ;issue the chord angle for a circle 

cmp AX, 100 730 degree max 

jbe PCA 

add SI, 4 ;next chord angle 

cmp AX, 250 715 degree max 

jbe PCA 

add SI,4 ;next chord angle 

cmp AX, 500 ;10 degree max 

jbe PCA 

add SI,4 ;next chord angle 

cmp AX, 1000 ; 5 degree max 

jbe PCA 

add SI,4 ;next chord angle 

cmp AX, 2000 ; 2 degree max 

jbe PCA 

add SI, 4 ;use 0 degree chord angle 
PGA 

call Put_Output 

ret 
Put_CHORD_ANGLE endp 
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assume DS:PLOTTER 


coo eee ee oe eee ee eee eee ee ewe ee eee eee ee ee oe seer eee eer eereeres ere reser e esos ese ere see eee @ 


GREER OLA EEE LOR EVE EEPROM EGR ET OEP OOD EEL EOC ELE OC RL US OIE FFD TOR tae eee 


; Compare XY: 


; enter with CX holding X value, DX holding Y value 
; compare X,Y with the current X,Y 
Rs return with AL=1 if equal, else AL=0 


Se 


LEO EE ERED EI I BER OIG BRK OO ROAR IK OO OI I OG ROO AAI PBI OIE FT PAO PECs CORON ee ara tae ar ae 


Compare XY proc near 


mov AL, 1 

cmp CX,Current_X 

jnz Compare XY_Exit 

cmp DX,Current_Y 

jnz Compare XY Exit 

inc ax 
Compare XY _ Exit: 

dec ax 

ret 


Compare XY endp 


; rindi keecnnGuee 

; calculate the arc's angle and its direction the plot's pen should move 

A from (Xel,Yel) to (Xe2,Ye2) 

f Xc,Yc,Xel, Yel, Xe2,Ye2,Radius are referenced the pointer passed in ES:BX 

; return with an angle: negative angle specifies clockwise movement 

; positive angle specifies counter clockwise movement 


a 


FEPFUFEPEOPROMITETCROERAEEEEVOEDPUTECEEEEREVEFEES EO UD GAL CLb PLO FD bLP_F be PLO. UL Cub bireoun nein ances 


Find_Arc_ Angle proc near f 
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les BX, Current Pointer 
; find starting point's angle with respect to X-axis 


mov SI,ES: [BX] .PA_Xel 
sub SI,ES: [BX] .PA_Xc 
mov DI,ES: [BX] .PA_Yel 
sub DI,ES: [BX] .PA_Yc 
call Find Angle 
push AX ;Save starting point's angle 
; find ending point's angle with respect to X-axis 
les BX, Current_Pointer 
mov SI,ES: [BX] .PA_Xe2 
sub SI,ES: [BX] .PA_Xc 
mov DI,ES: [BX] .PA_Ye2 
sub DIP ESalBXIs PARC 
call Find Angle 
push AX ;save ending point's angle 
; find quadrant where starting point is on 
les BX, Current Pointer 
mov SI,ES: [BX] .PA_Xel 
sub SI,ES: [BX] .PA_Xc 
mov DI,ES: [BX] .PA_Yel 
sub DI, ES: (BX) .PA_Yc 
call Find_Quadrant 
mov DX, AX ;save in dx 
; find quadrant wher ending point is on 
les BX, Current Pointer 
mov SLES (BX) PAL xXeZ 
sub SI,ES: [BX] .PA_Xc 
mov DI,ES: [BX] .PA_Ye2 
sub DI,ES: [BX] .PA_Yc 
call Find Quadrant 
; call appropriate routine to calculate arc angle and its sign 
pop DI ;xrecall ending point's angle 
pop Sr ;recall starting point's angle 
mov CL, 4 
xchg DX, AX 
mul CL 
add AX,DX 
mov BX, AX 
shl Bx, 
call word ptr Calculate Table [Bx] 
Lee 
Calculatel: 
mov AX,DI POLANGLew—ToRAngLe 
sub AX, SI 
ret 
Calculate2: 
mov AX, 180 7180 - ( S Angle + E Angle ) 
sub AX, Ss 
sub AX,DI 
ret > 
Calculate3: a. 
mov AX, 180 ; - (180 - (S Angle + E_Angle)) mn 
sub AX, SI = 
sub AX,DI g 
neg AX He 
ret n 


D-57 


7S Angle — E Angle 
7S_Angle + E_ Angle 


7 = Noe ANGLe + BeaAngle) 


Calculate4: 
mov AX, SI 
sub AX, DI 
ret 
Calculated: 
mov AX, SI 
add AX,DI 
ret 
Calculateé: 
mov AX, SI 
add AX,DI 
neg AX 
ret 
Find Arc Angle endp 
; Find Angle: 
5 given X-Xo,Y-Yo, 


enter with SI holding X-distance, 


; return angle in AX 


2 O10 © Be &):S\ewe © © 2 S © ‘ele 6 el) le/'si's so 6 0 6 2 6 ‘S eles fle! ls (c sels. ce wiry sRnele ens epsiokehe 9 « wis (6 616 © %) ee sie isin 
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find an angle of the line with respect to X-axis 
DI holding Y-distance 


CUETO EEMOROCE ERE RR EGER OD FE ERED CHE URED SAD CRE FOF CMe LOTT FT OOOO E HPL Dt Pein eevee reer 


Find Angle proc near 


or 
jns 
neg 
¥_ Checks: 
or 
jns 
neg 
Compare: 
xox 
cmp 
jge 
Mov 
xchg 
Calculate Tan: 
xOr 
mov 
mul 
div 
xor 
Lookup _ Tan: 


jmp 
Take Previous: 
sub 
Check_Tan_Cot: 
shr 
or 
jz 
mov 
sub 
I op aie - 
Bec 


DI,DI 
Y_Check 
DI 


Sis 
Compare 
SI 


CX, CX 

SI,DI 
Calculate Tan 
CX,1 

SI,DI 


DxX,DX 
AX, 10000 
DI 

SI 

BX, BX 


AX, Tan_Table [BX] 


Check_Tan_ Cot 
Take Previous 
BX,2 

Lookup Tan 


BX, 2 


BX, 1 
Cx,Cx 
FA_Exit 
AX, 90 
X, BX 


Find Angle endp 
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7Y_distance 


;X_distance 


;X_distance >= Y_distance 


;cx=1 signals a cotan calculation 


stan = Y/X 


;index bx is also angle 


;previous angle 


jangle in bx 


;angle=90-angle in cotan calculation 


SPL ERC Pa SE eat ERT TR Woe OTe ea ee aL eer Ss Or a6 08) sO) (91'S), ©! 16: S) Tee) 1e/ V9) ei10: Ce. ol at 6.10: 58) 6o la Est ei eye) S:@) 8,64 SOUS, OMOy al ee oe 8 8 6S. 
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; Find Quadrant: 


5 find a quadrant where a point (X,Y) is on 
p enter with SI holding X, DI holding y 
3 return AX=quadrant number 


FESR RR ROL er Te RI Teen ee ne eae ee PS Te eens (ohie 8 U8ne eis: si wth els] -e.\0 | (a) (si 6)-0)'% (6 ene. Ue). ©) ‘el & ele Melee ie [6.6 4) Br enSive) e1p ie « 6 
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Find Quadrant proc near 


xor AX, AX 
cmp SI, 0 
je Check_Y 
j9 X_Positive 
inc AX 
X_Positive: 
inc AX 
Check_Y: 
xOr BX, BX 
cmp DI,0 
je Lookup_Quadrant 
jg Y_ Positive 
inc BX 
Y_ Positive: 
inc BX 
Lookup Quadrant: 
mov Chis 
mul CL 
add BX, AX 
mov AL, Quadrant_Table [Bx] 
xOxr AH, AH 
ret 


Find Quadrant endp 
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re ee Sarena Le) elEe! 818) w) ole Lee) ie) e908) (8 aie (6 lo @; @ileie: ee ers (wv) 6 6 (0: 6\ 6 je 'e).6 6. « 4 015 & 6 © 0d 6 6 815, 06. 9. 0-0)'6) « 8 © w 6 0 @ @ 0 ae 
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INITPLOTTER db Wels VAC Ais Wa) 
BEGINPLOT db UPURDE REA? "10 
ENDPLOT db SEU Sibi aO ; 
SETVELOCITY db RUSS XG) 
SETPEN db CSO 
CIRCLE db SCE 0 
ARC db "AA',0 
SETDASHLINE db VGH A alg E EMO) ;pattern 2, 1/8in length 
RESETDASHLINE db SEO 
SETCHARSIZE db NSE UES (0) 
LABEL db SDB 20 
PENUP db "PU;PA',0 
PENDOWN db UP Dip PAY, 0 
COMMA db SAO 
TERM db en, 
CHORD_ANGLE db ASO 0 

db Sa a0 

db HOO 

db Pel Ola 

db TAA On 

db OOO 
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Quadrant _Table db Lei Oy 974 
db 3,0,3 
db appl ae 

Calculate Table dw Calculatel,Calculate2,0,Calculateé 
dw Calculate3,Calculate4, Calculates, 0 
dw 0,Calculate6,Calculatel,Calculate2 
dw Calculate5S,0,Calculate3,Calculate4 

Tan_Table dw 0000,0175,0349,0524,0699,0875,1051,1228,1405,1584 
dw 1763,1944,2126,2309,2493, 2679, 2867, 3057, 3249, 3443 
dw 3640, 3839,4040, 4245, 4452, 4663, 4877,5095,5317, 5543 
dw 5774,6009, 6249, 6494, 6745, 7002, 7265, 7536, 7813, 8098 
dw 8391,8693, 9004, 9325, 9657,10000 

Last_Velocity dw 0 

Last_Acceleration dw 0 

Last_Force dw 0 

Last_Pen dw 0 

ASCII _ Fixed db '00.000',0 

Negative Flag dw 0 

Negative Sign db Feat 

ASCII_Word db '00000',0 

Character db & 

Text db Ae) celbtey ((')) 

Buffer db 1024 dup (?) 

Buffer Count dw 0 

Buffer Size dw 1024 

Poly Flag dw 2 

X_Offset dw 2 / 

Y_Offset dw eZ Xv 

Current_X dw % 

Current_Y dw & 

Current_Pointer dd e 

Channel dw 3 

Handle dw ? 


PR PO ERC EC ERE RR REE Pie Sie © 8) 8: le '5) 6) 6, (0 [ei .8) 9:0 a) 6)"6 6 i ol im 16] (site! \e).s\ eile ¢ 6 6 6 ©) (0) gis; as) (6) &\ 06. (6; als) oie neue a arene 


; the driver can be reduced 
End_Of_File Location db 4 


PLOTTER ends 
end 


D.4 SOURCE CODE FOR GENERIC PLOTTER DRIVER 


PAGE 64,132 
NAME Generic Plotter Driver 


PORE RERECCELEC HEREC EEE REPEL SS SSS Som Sis, clo cho 6 0 6 oie Sate * © © sles © > © 10 0 6) 0.6) \6 0 ese) eieatnenenee een ne 
OEE OE LEOCCLOCUEE ECE LEROTEUEGDDREOE ENON TE LODE FER POE DEEEOEEEREEVD FF 8 FIG Cir CHORE 


+ DECLARATIONS 


LER E EE EE CO Eo oS Myles she's © 910, 6.10) ele ate: el wter's | of's, s\'e)e ja) 6 eee 0. alisis) (a ee ater eiien same neneemetie oo ete eee eee eee 
POOCEEOERLOR EERE LE UIC ED LL EOE ER OAD IPS CRT EEE CRE OR TLE OO FOE LG 4 ERT TREE Onate PRTG G 


Save DS MACRO 
push DS ;save old DS 
push CS 
pop DS restablish DS addressability 


assume DS:PLOTTER 
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ENDM 


Restore DS MACRO 
pop DS ;restore DS 
assume DS:nothing 
ENDM 


;error codes 


E_OK equ 0 
E_Invalid Function equ 1 
E File Not_Found equa 2 
E_Path_Not_Found equ 3 
E_No_ Handles _ Left equ 4 
E_Access_Denied equ 5 
E_Invalid_ Handle equ 6 
E_Bad Control Block equ 7 
E_ Memory Limit equa 
E_ Bad Memory Address equ 9 
E_Bad_ Environment equ 10 
E_Bad Format equ 11 
E_Bad_ Access_Code equ 12 
E_Bad_ Data equ 13 
E Disk_Full equ 14 
E_ Bad Drive Specified equ 15 
E_Current_Dir_ Remove equ 16 
E_Not_Same_Device Geis) 287 
E_No_More Files equ 18 
;ASCII codes 
Cr equ ODh 
Lf equ OAh 
;parameter passing structures 
Parameter struc 
P_Channel dw B ills 
P_ Baud Rate dw 2 7110, 150, 300, 600, 1200, 2400, 4800, 9600 
P Parity db a 70 (mone), 1 (odd), 2 (even) 
P_Word_ Length db 2 ligas 
PESTOPEBLES db 2 Wika 2 
P_ Handle dw i 
Parameter ends 
BP struc 
BP_X Offset dw % 
BP_Y Offset dw @ 
BP ends 
PL struc 
PL Xs dw & 
PL_Ys dw 2 
PL_Xe dw 2 
PL_Ye dw 2 > 
PL ends zo 
vU 
m 
PE struc = 
PE _Xc dw 2 = 
PE Yc dw ? 3. 
PE_Xr dw ? o 
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PE -Yy dw ? 
PE ends 

ke struc 

PC _X dw ? 
XG 3 dw ? 
PC_Radius dw & 
xe ends 

PA struc 

PA _Xc dw & 
PAT Yc dw ? 
PA_Xel dw & 
PA_Yel dw 2 
PA_ Xe2 dw a 
PA Ye2 dw % 
PA_ Radius dw es 
PA ends 

PDL struc 

PDL Xs dw ? 
PDL Ys dw z 
PDL Xe dw 2 
ED ie Xe dw z 
PDL ends 

PT struc 

PT X dw 2 £ 
PT Y dw 2 : 


PT Height dw 
UR epatyeves jo) <elcl 
Ea ends 


Nv 


STACK segment stack ‘STACK' 
STACK ends 


PLOTTER segment public 'PLOTTER' 
assume CS:PLOTTER 
assume DS:nothing 


7 Plotter Driver 

; interface to Plotter driver is made with a series of far calls 

; all parameters are passed via registers, the specific registers are 
; detailed for the sub-command 


oe 0 © ee 6 0 we eS cle ee ce 6 6 6 fe 6 6 6 we 6 86 ee © Bie 


Plotter Driver proc FAR 


jmp Initialize Driver 
jmp Initialize Device 
jmp Begin Plot 

jmp End_Plot 

jmp Set_Velocity 

jmp Set_Acceleration 

jmp Set_Force 

jmp set Pen 

jmp Plot_Line 

jmp Plot Circle 

jmp Plot Ellipse 
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jmp EPLOERAZS 


jmp Plot _Dashed_Line 
jmp Plot Text 

jmp Poly Begin 

jmp Poly End 


Sign_On_Message db 'GENERIC Plotter Driver vV3.00',0Dh,0Ah,'S' 
COPYRIGHT_NOTICE db '(C) Copyright 1987 OrCAD Systems Corporation! 
db ' ALL RIGHTS RESERVED.','S! 
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Initialize Driver: 
sign on ‘ 
set Ctrl-Break check to TRUE 
shrink the required memory 
return STATUS in AL 
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Initialize Driver: 


Se Me Me te te 


Save_DS 
; display the program title, revision and copyright notice 
mov DX, offset (Sign_On_ Message) 
mov AH,09h 
int 21h ;print Sign_On Message 
mov DX, offset (Copyright Notice) 
Mov AH, 09h 
stighe 21h sprint Copyright_Notice 
* set Control-Break checking in DOS to TRUE 
mov AH, 33h 
mov AL, 1 
mov Dh, 
int 21h 
; return unused memory to the pool 
mov AX,CS ;segment address of this overlay 
mov ES, AX ;recall segment address 
Mov BX, offset (End_Of File Location) 
mov CL, 4 
shr BX,CL 
add BX, 2 
mov AH, 4Ah ;modify allocated memory blocks 
int eth 
Restore DS 
Bet 
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Initialize Device: 
initialize the device 
if the handle is <> 0 then write only to the handle 
if the handle = 0 then initialize the serial channel 
pass in via ES:BX a pointer to the PARAMETER structure 
return STATUS in AL 


HH Me Se Me Ne Se Me Ne 


= 

EPEC TERED CLIT HRSAITSERIF ACIP CREE RE ERDAT DRED OOO E REST OORE RS ER ETT RTE RERR ERTS bs 
nitialize Device: m 
Save_DS = 

xXOr AX, AX Pe! 

mov Buffer Count,Ax ;clear Buffer Count e 

mov Last_Pen, AX ;clear Last_Pen ” 
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mov AX, ES: [BX] .P_Handle 

mov Handle, AX 

or AX, AX 

jz ID_ Serial 

jmp ID_Handle 
ID Serial: 

mov AX, ES: [BX] .P_Channel 

dec AX ;convert the channel from 1..2 to 0..1 

mov - Channel,Ax 

xOr AL, AL 

mov CX,ES: [BX] .P_Baud_Rate 

cmp CXoe 0 

je Found Baud Rate 

add AL,00100000b 

cmp CXp oO 

je Found Baud Rate 

add AL,00100000b 

cmp CX, 300 

je Found Baud _ Rate 

add AL, 00100000b 

cmp CX, 600 

je Found Baud Rate 

add AL,00100000b 

cmp CX7 LUG 

je Found Baud Rate 

add AL, 00100000b 

cmp CX, 2400 

je Found Baud Rate é 

add AL,00100000b : 

cmp CX, 4800 

je Found Baud Rate 

add AL,00100000b 

cmp Cx, 9600 

jne ID_Error Exit ;if not found, exit without changing port 
Found Baud Rate: 

mov CL, ES: [BX] .P_Parity 

cmp CLA0 

je Found Parity 

add AL, 00001000b 

cmp CL,1 

je Found Parity 

add AL,00010000b 

cmp Chie 

jne ID_ Error Exit ;if not found, exit without changing port 
Found Parity: 

mov CL, ES: [BX] .P_Stop Bits 

cmp CL,.1 

je Found Stop Bits 

add AL, 00000100b 

cmp Chaz 

jne TDMEETOnm Exit ;if not found, exit without changing port 
Found Stop Bits: 

add AL,00000010b 

mov CL, ES: [BX] .P_Word_ Length 

cmp Cie 

je Found Word Length 

add AL, 00000001b 

cmp CL, 8 
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jne ID_Error Exit 7if not found, exit without changing port 
Found Word Length: 


mov DX, Channel 
cmp DXx,0 
je Found_ Channel 
cmp Dx 
jne IDSETTOLeExXLt sif not found, exit without changing port 
Found Channel: 
mov AH, 0 sinitialize function 
int 4h + ;bios com interrupt 
mov SI,offset (ID_String) 
call Put_Output 
Restore DS 
fate 
EDEE Tron exit: preturn error code 
mov AL,E_ Bad Environment 
Restore DS 
ret 
ID_Handle: 
mov AL, E_OK ;since not serial return E_OK 
Restore DS 
ret 
AMA DPT TEOMA MMIUIERA CNERINENE CLOUT ELD RRL T PRE ERO C OR FLTC tebe ye RGA TORR PREC ESR EE ES 
; Begin Plot: 
; called at the beginning of the plot of the current sheet 
; x_offset, y offset are pointed to by a pointer passed in ESBX 
; return STATUS in AL 
ee eee Meee PE OIE OOO POLI Ie Oe Pe COOL ONEOR FOO COP OO OE UFO ONO EV COMED OEE OE OO ECA ECREROE ED? 
Begin Plot: 
Save_DS 
mov SI,offset (BP_String) 
Mov word ptr Current _Pointer([0],BX 
MOv word ptr Current _Pointer([2],ES 
cali: Put_Output 
3c BP_Error Exit 
les BX, Current Pointer 
mov AX, ES: (BX] .BP_X Offset 
test Ax, 8000h 
jz BP_X 
neg AX 
push AX 
call put_MINUS 
pop AX 
BP_X: 
call put_Fixed 
jc BP_Error Exit 
call put_COMMA 
axe BP Error Exit 
les BX,Current Pointer 
mov AX, ES: [BX] .BP_Y Offset 
test AX, 8000h D> 
jz BP oY 3 
neg AX m 
push AX re 
call — put_MINUS 2 
pop AX - 
Bry: n 
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call put_Fixed 
j¢ BEB Ear Or masa 
call put_TERM 
BP Error Bxit 
Restore DS 
ret 
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; End Plot: 
§ called at the end of the plot of the current sheet 
; return STATUS in AL 


SS 8) C8 OS 8 AL Re 9 OSS) OMA e. Lee (SR. el eee: Vee, Bl @; (6,181) 6) .6) le) ‘o: (6! eee) & 8) .6)' bile) eo aie Ine RAST co ae ae ee ee PN eer ei 
CRORE E EEO RAEI CIEL EP EOE ERE ED TROL AI I FOR CLUE D EG HAM CORI aravaTe FOP Eb oF Rip pee E Ee 


End _ Plot: 


Save_DS 

Mov SI,offset (EP_String) 

call Put_Output 

ike: CPi Exit 

call Flush_Buffer 7Since this is the end of the sheet 
CPHEXit: 

Restore DS 

ret 
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; Set_Velocity: 


; set the plotter current pen to the velocity passed in BX 
; return STATUS in AL 
Set_Velocity: ( 
Save_DS 
cmp BX, Last_Velocity ;new velocity = last velocity ? 
je Velocity Unchanged j;yes, no change neccessary 
Mov Last_Velocity, BX ;no, save new velocity 
Mov SI,offset (SV_String) 
call Put_Output 
site: SVL EDrOESEXEE 
mov AX, Last_Velocity 
call Put_Word 
jc SV_Error Exit 
call Put_TERM 


Velocity Unchanged: 

SV_Error Exit: 
Restore DS 
ret 


cece ec eee ecco e ete ee tae ig RE I CN fag a er a), Ub ee CN: OY ee Che Rey CARCMCY x1 ry ee eee eee eo ee ese eee ee eee eee 
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; Set_Acceleration: 
; set the plotter current pen to the Acceleration passed in BX 
return STATUS in AL 


eee ee eee ee ORC ee LEE FOSS 2 28 O18 Oe Dis 0 © 0:8 se 0 is 6 8.9.6 oe \e)einy +. 6 Jes © ia, bhel + “ie 6) oie) alienate eee 
FEO OEE ERG DM PL CE OAIMAWL EAE V ELLE E ELI ARB E PED DS WWI D BENG FBO 0.18 6.5 PaeMEKE FF8L Ee Ee 


Set_Acceleration: 


Ty 


Save DS 

cmp BX, Last_Acceleration 7new Acceleration = last Acceleration ? 

je Acceleration Unchanged ;yes, no change neccessary 

mov Last_Acceleration, BX 7no, save new Acceleration 

mov SI,offset(SA_String) 

call Put_Output 

je SA_Error Exit 

mov AX, Last_Acceleration € 
x 
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call Put_Word 

ae SAZEDrOr Exit 

Cael Put_TERM 
Acceleration Unchanged: 
SA_Error Exit: 

Restore DS 

Sec 


RUSLAN Sy LST. S.-0) 2 8! 0 6! ose 9m! te) 6. 6 a's Gs SLPS 8) C6 eee OSes. Cue Le woneel ele (eves 0.2 « # sHelip te ©, @ 6 @ “0,6 6 8 6 6 6 6 0 6 6 @ = 0.6 


se 
PEP IRIONONO FREESE CR ACN? CM CR ENA FP 060 PIC P ICLP 1 VEPET GPS UFED YE PGRRIRD RAPA SENEELEE FO TE TMP DR ORR ERE PE DERE FO 08 


SEEEEOLCe: 
set the plotter current pen to the Force passed in BX 
return STATUS in AL 


™ 


CT re se Ne Ne fe 
~ 


TM CCOMLOT ERE LEDUC TARR OTR ODP EDDY LIED FOOL FY MEUEROREMELCUPAE TP FOE GHEMPTOTE ROR PERE OTERO RG EE BR 
et Force: 
Save_DS 
cmp BX, Last_Force 7new Force = last Force ? 
je Force Unchanged ;yes, no change neccessary 
mov Last_Force, BX ;no, save new Force 
mov SI, offset (SF_String) 
Carl Put_Output 
jc SF_Error Exit 
mov AX, Last_Force 
call Put_Word 
Ic SF Error Exit 
call Put_TERM 
Force Unchanged: 
S19) Japepctobe Japiehen 
Restore DS 
ret 
MEM UTUr GF ALOIL FFF FFAG PAMIEALAE GP URAL EAE GUE DEUS DS FLLS CLERIROAT OEE FOF HIG EOE EERE OR GbE BUDE 8 OO BNE 
; Seturen: 
; set the plotter current pen to the Pen passed in BX 
; return STATUS in AL 
BMTRA RANE TFLS FNPRSG PI FUPLELCLOURUILDIOIELFURLG SURE RCVAURLTAE OGRA ED GPR RFUE PRED ERT ORO RE TERE ODOR RUE DE FOr EERE 
Set_ Pen: 
Save_DS 
cmp BX, Last_Pen ;new Pen = last Pen ? 
je Pen_Unchanged ;yes, no change neccessary 
mov Last_Pen, BX 7no, save new Pen 
mov SI,offset (SP_String) 
call Put_Output 
ate SP_Error Exit 
mov AX, Last_Pen 
call Put_Word 
je SP_Error Exit 
call Put_TERM 
Pen_Unchanged: 
SPebrror Exit: 
Restore DS 
rec 
CAD AMELIE FLSA DUGLALPAPLEU GLEE PPLE OR F1F FED PPURILINGLE DIPAPAGEEUE FFD PLE ER OULECTO FERRO ROLE RES EE 
; Plot Line: 
; plot a line 
; Xs, Ys,Xe,Ye are pointed to by a pointer passed in ES:BxX 
; return STATUS in AL 
GUEMPLIADTE AE TGIGL OAL DUPORLD UL PUP IAMSUD DLE IRG BLP FP DLP GATS OLED LF GHPMORPTURORIDT OG: Fb FOMEPETETE COPE PORE RRR ERE TECE 
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Plot Line: 
Save_DS 
mov 


call 
PLSBLrOmrenxite 


word ptr Current Pointer[0],BX 
word ptr Current _Pointer(2],ES 
SI,offset (PL String) 
Put_Output 

PL Error Exit 
BX,Current_ Pointer 
AX, ES: [BX] .PL_Xs 
Put_Fixed 

PLYBrror ExXLe 
Put_COMMA 

PLUBETOr Exit 
BX,Current_Pointer 
AX, ES: (BX].PL_Ys 
Put_Fixed 

PL Error Exit 
Put_COMMA 

PVE Gror Exrt 
BX,Current_ Pointer 
AX, ES: [BX] .PL_Xe 
Put_Fixed 

PL Error Exit 
Put_COMMA 

pb jopareesa, japialic 
BX,Current_ Pointer 
AX, ES: [BX] .PL_Ye 
Put_Fixed 

PL Error Exit 
Put_TERM 


Restore DS 


ret 


ee ee eee 


ed cee eee 


eee 
CEOECULOOVE CEM EER EEROCOE EVE OEE EEO OLOEEAD ERE BRE DEL OUEEUD OOF 9 0 E96 F F Unter FES ener rar ee 


; Plorucirre le’: 


; plot a Circle 


; X,Y,Radius are pointed to by a pointer passed in ES:BX 
; return STATUS in AL 


PLOERC UEC her: 
Save_DS 
mov 
mov 
mov 
call 
aK 
les 
mov 
call 
HS 
call 
aK 
les 
mov 
call 
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word ptr Current _Pointer[0],BX 
word ptr Current Pointer[2],ES 
SI,offset (PC_String) 
Put_Output 

PC_Error Exit 

BX,Current_ Pointer 

AX, ES: [BX] .PC_X 

Put_Fixed 

PC Error Exit 

Put COMMA 

PCRE EOD mrs te 

BX,Current_ Pointer 

AX, ES: [BX] .PC_Y 

Put Fixed 


eee eee ee eo eee eee eo ee 


ic PC Error Exit 


S(O) Inpecte sah} ahee 


eo eee eee ee ee ee eee 


Plot Ellipse: 


call Put_COMMA 

jc PC _ Error Exit 

les BX,Current_Pointer 
mov AX, ES: [BX] .PC_Radius 
call Put Fixed 

ate PC Error Exit 

call Put_TERM 

Restore DS 

Eec 


plot a Ellipse 


Shier See e Crte) WS sei el OOO eT Cee ee. eRe BOS, ie 2.0 (6/06 6) 16) le) 0, oe alte a 6.8: 6) 8) @, 6) S\8t 6 6) ee. \e: 


Xc,Yc,Xr,Yr are pointed to by a pointer passed in ES:BX 


return STATUS in AL 


eee ae yaa e 1S: (uO) e Si.s) (8), Os) 18.858 Cm Tee ee Lele Pilet Sie iae) 6) els: woe) ces) 6s) a) Puke! <6) '@ ane, 9 0/6) e/ele .o s €: 2° 6. O:4 8\10 6 ee “e868 @ 0 @ 


Plot Ellipse: 


Save _ DS 

Mov word ptr Current Pointer[0],BxX 
mov word ptr Current Pointer(2],ES 
mov SI,offset (PE_String) 

call Put_Output 

ale: PE EBrror_Exit 


les 
mov 
call 
aK 
call 
Ke 
les 
mov 
call 
jc 
call 
aKe- 
les 
mov 
cali 
ake’ 
Cali: 
ake! 
les 
mov 
call 
aye 
call 
PESSLLOLepx it: 


BX,Current_Pointer 
AX, ES: [BX] .PE_Xc 
Piitmbelxed 

PE_ Error Exit 
Put_COMMA 

PE Error Exit 

BX, Current Pointer 
AX, ES: [BX] .PE_Yc 
Put_Fixed 

PE Error Exit 
Put_COMMA 

PE Error Exit 
BX,Current_Pointer 
AX, ES: [BX] .PE Xr 
Put_Fixed 

PE Error Exit 
Put_COMMA 

PEeBrrorn Exit 

BX, Current_Pointer 
AX, ES: [BX] .PE_Yr 
Put_Fixed 

SAD NaveaOpe _japieekls. 
Put_TERM 


Restore DS 


cer 


PLOGLATGC: 


eo Se Fe Fe 


S58 Me LOL ee Or Sele (Ole 6: 16) 0) le, (6 (0110 16716159. 16, © 6S (e) 0) 8) .8) 16 0, O18) © © (0) 6 0) 0 $0) 6 (0114. 8 (0 16:8 © 6 8.6) 0 6 © w 0. 8 


plot a Arc 
Xc, Yc, Xel, Yel, Xe2,Ye2,Radius are referenced the pointer passed in ES:BX 
return STATUS in AL 
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Plot Arc: 
Save_DS 
Mov word ptr Current_Pointer[0],BX 
mov word ptr Current _Pointer[2],ES 
mov SI,offset (PA_String) 
call Put_Output 
Ke PA Error Exit 
les BX, Current Pointer 
mov AX, ES: [BX] .PA_Xc 
call Put_Fixed 
Bie PA Error Exit 
can Put_COMMA 
ake’ PA_Error Exit 
les BX,Current_ Pointer 
mov AX, ES: [BX] .PA_Yc 
call! Put_Fixed 
ae PA Error Exit 
call Put_COMMA 
je PARE ETO rib cite 
les BX,Current_ Pointer 
mov AX, ES: [BX] .PA_Xel 
call Put_Fixed 
jc PA _Error Mhapelie 
call Put. _COMMA 
je PA_Error Exit 
les BX,Current_ Pointer € 
mov AX, ES: [BX] .PA_Yel ; 
call Put_Fixed 
je PA Baron Exit 
call Put_Fixed 
jc PA_Error Exit 
les BX,Current_Pointer 
mov AX, ES: (BX] .PA_Xe2 
cali Put_Fixed 
jC PA_Error Exit 
call Put_COMMA 
je PA_Exror_Exit 
les BX, Current Pointer 
mov AX, ES: [BX] .PA_Ye2 
call Put_Fixed 
je PALError Exit 
call Put_Fixed 
je PA_Error Exit 
les BX,Current_ Pointer 
mov AX, ES: [BX] .PA_Radius 
call Put_Fixed 
jc PA Error Bxit 
call Put_TERM 


PA Error Exit: 
Restore DS 
ret 


; Plot (ashed: Dede: 
; plot a Dashed Line 
; Xs, Ys,Xe,Ye are pointed to by a pointer passed in ES:BX 


. return STATUS in AL 


ccs see ee eee eee eee eee eee eee eee eee eee eee seer eee eee eee sree eeee eee seer ee eseer eee ees 
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Plot _Dashed_Line: 


Save_DS 

mov word ptr Current_Pointer(0],BX 
mov word ptr Current _Pointer[2],ES 
mov SI,offset (PDL String) 
call Put_Output 

je PDL Error Exit 

les BX,Current_Pointer 
mov AX, ES: (BX].PDL_ Xs 
call Put_Fixed 

je PDL Error Exit 

call Put_COMMA 

3¢ PDL Error Exit 

Les BX,Current_Pointer 
mov AX, ES: [BX] .PDL_ Ys 
call Put_Fixed 

je PDL Error Exit 

Camry Put_COMMA 

3 PDL Error Exit 

les BX,Current_Pointer 
mov AX, ES: (BX] .PDL_ Xe 
call Put_Fixed 

je PDL _ Error Exit 

call Put_COMMA 

ae PDL Error Exit 

les BX,Current_Pointer 
mov AX, ES: [BX] .PDL_Ye 
call Put_Fixed 

He BD iwE rr Ole nsct 

call Put_TERM 


POLSErcOng ext: 
Restore DS 
ret 


oo eee eee eee eee eee eee eee ere eee reese eee soe see ere eee eee eee eee eee ee 
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mle xts 
plot a Text string 
String_p,X,Y,Height are pointed to by a pointer passed in ES:BX 
return STATUS in AL 


ze Ve 


The plotting routine expects the character-to-character space to be 
equal to 4/3 the height passed in. 


eee ee eee ee ee ee ee eee eee eee eee eres e see eoe eee oe eee ose ee ee ee oe eo oo 
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lot_Text 

Save_DS 

MOv word ptr Current_Pointer[0],BX 

mov word ptr Current Pointer[2],ES 

mov SI,offset (PT_String) > 
call Put_Output Ss 
je PT Brzor_Exit mr 
les BX, Current_Pointer z 
mov AX, ES: [BX] .PT_X 9 
call Put_Fixed Sa 
We PT Error Exit Yn 


call Put_COMMA 
jc PT Error Exit 
les BX, Current_Pointer 
MOv AX, ES: [BX] .PT_Y 
call Put_Fixed 
jc PT Error Exit 
call Put_COMMA 
je PT_Error Exit 
les BX,Current_Pointer 
mov AX, ES: (BX] -PT _Heaght 
call Put_Fixed 
JC PT Error Exit 
cali Put_COMMA 
jc Bile Eprom. Sic 
call Put_Quote ;open string 
BK) PT Error Exit 
;copy the string from the pointer to the text buffer and convert to null-end 
les BX, Current _Pointer 
push DS ;save DS 
mov DI,offset (Text) ;make ES:DI point to text buffer 
push DS 
lds ST, bS? (BX) sPtnStxing ip 
pop ES 
lodsb ;get string count 
xOr AH, AH ;convert to word 
mov CX, AX ;use as move count 
eae! 
rep movsb a 
xOr AL, AL q 
stosb ;make last byte a null 
pop DS ;restore DS 
Mov SI, offset (Text) 
call Put_Output ;transfer line 
jc PIS BETO re Bale 
call Put_Quote ;close string 
jc PT _Error_Exit 
call Put_TERM 


PT Error Exits 
Restore DS 
ret 
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ponpeneg inv 
mark the beginning of a poly vector stream 
pass pipe STATUS in AL 


© 0 0 0 6 6 6 Old © 0 © 6 @ 0 Sts 0.00.10 Sus 0 0 ,0l es lene ele else 6. wees) © 61> @J9 e160 @ Shape Shee epee © 6 ¢ 0 6.10 (E81 s) [eee e lee oe 


Poly Begin: 

Save_DS 

mov Poly Flag, 0FFh 

Mov SI,offset (P_B String) 

call Put_Output 

Restore DS 

ret 
PERG T EE EEE EE BEB TRG TT TUTE Bet tIELP LePUPSTUEMIUE EADIE F PUENOUROP IE TY FFT) FLAP TERED GL0 007, Cen TACRPRER On Zea iene 
; Poly End: 


; mark the end of a poly vector stream 
; pass back STATUS in AL 
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POLy End: 


Save DS 

mov Poly Flag, 0 

mov Si OGrsek (Pabeot rang) 
call Put_Output 
Restore DS 

=e 


Plotter Driver endp 


Chere vali Lae (6:1 ke, 6) ie le: ce: eile fe, wire 6 e e7te) s- \9 lenis Kee 0) eo 6.6 ere ae 
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assume DS:PLOTTER 


7. 
™e 


Put_Output: 


me te Ne Me Ne 


Put_Output proc near 
Get_Character: 


lodsb 

mov Character, AL 
or AL, AL 

jnz Send_Character 
CUS 

ree 


Send_ Character: 


C {a0 ee) ease. (a! >) [el 6.16. 8 (0.0) ‘a. 86 16) @ 6 a) 6 6, = 0 e. 0) @)\e ad 


coe ee oe 


sent the null terminated ASCII stream to the output device 
return the STATUS in AL, if <> E_OK then set the carry flag 


ose ee eee eee = eo) ses alee oS) e, fe) 2s) we) ee) eae Ue, SL 8! 19) et ee) 6) ere les oi \b) (ele 16) 6 16, :6) ws (66. e660. 6.0) 8 « 6.6: 9. 6:8 6 8 wie 6 
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get character from DS:SI 
;save character 


; check STDIN so that DOS will stop program if Control-Break is typed 


mov AH, OBh 

int 21h 

cmp Handle, 0 

jne Not_COM Port 
mov DX, Channel 
mov AH, 3 

int 14h 

test AL,10h 

We Send_Character 
mov AL, Character 
Mov DX, Channel 
mov AH, 1 

int 14h 

test AH, 80h 

jnz Send_Character 
jmp Get_Character 


Not_COM Port: 


mov CX, Buffer Count 
cmp CX, Buffer Size 
jne Put_Character 
call Flush_Buffer 
jne Put_Character 
ret 

Put_Character: 
mov AL, Character 
Mov BX, Buffer Count 


;Check Standard Input Status 


;check Handle 

;if handle <> 0 then output via DOS 
get current channel 

;COM PORT STATUS 

;bios com interrupt 

jis CLEAR TO SEND set 

Gelbe BevoKey, soKeyes 

;recall character to send 

;get current channel 

7COM SEND CHARACTER 

;bios com interrupt 

;was character send 

;time out, so retry 

;character was sent, so do next 


PEeestemcheck, if the buffer is full 
;get current buffer load count 
;compare to the max buffer size 
puLcebuLterns notculi,. jump 

;else flush the buffer 

;if there was no error, continue 


*;get current character 
;get Buffer last load point 
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mov 
Ine 
mov 
jmp 


Buffer(BX],AL 
BX 

Buffer Count, BX 
Get_Character 


Put_Output endp 


;save the character in the buffer 


;save the new last loaded point 


;get next character 


; Flush Buffer: 
; send the entire buffer to the handle 
return the STATUS in AL with carry set if STATUS <> E_OK 


© 8 8 8 © © 6 ae e Cale 6 2: Swe we wile 6 s' lelielo.6 0) 's: 6.16 ie (9 8) of.e D6! 6 stele 16 (8) 4118) #4! (6 8 (019! . eels 


Flush_Buffer 


mov 
mov 
mov 
mov 
int 
I¢ 


proc near 

BX, Handle 

CX, Buffer Count 
Dx, offset (Buffer) 
AH, 40h 

21h 
Flush _ Buffer Exit 


;destination of write 
;how much to write 
;source of write 


jwrite 
;if error, exit now 


;check if the write count matches the written count 


cmp 


je 
mov 
ste 


AX, Buffer Count 
AL, E_OK 
Flush_Buffer Exit 
AL,E_Disk_Full 


Flush_Buffer Exit: 


Flush_ Buffer 


sg S) wi) 0 16) 6! (6 


ee 


mov 
ret 


Buffer Count,0 


;if counts match, then E OK 


yelse the disk is full 


;set the carry flag to indicate 


;reset Buffer Count 


; bull "Gonnin: 
; sent a COMMA to the ouptut device 
return the STATUS in AL, 


if <> E_ OK then set the carry fla 


g 


cee ee es eee ees ec ce 6 iw 6 8 6 ££ 66 0 8 6 8 8 © 8 6 ele 


oc eee eee ee eee eee 


eee ee ee 


error 


SRE TEE E CI ECS OEE TL OMELOIO OF VACAL TTF FEE CFU FFE Dutbadat SACAT Us SRRMERS 0 00) o puEheee =e Fb Curarearariree 
Put_COMMA proc near 

mov SI,offset (COMMA) 

call Put_Output 

ret 
Put COMMA endp 
nia a aaa Re ORO CLE UO EO OOD OMI DEL DOL DR GRO RNP ROEDER OG 22 6 
; Put _QUOTE: 
; sent a QUOTE to the ouptut device 
; return the STATUS in AL, if <> E_OK then set the carry flag 
DEERE TEPER TERED EOE DTG REDE DUC CRE ACRE ERED DAT FIbE DUG SANDID bo buhurun bt 0 die cir irinreE 
Put_QUOTE proc near 

mov SI, offset (QUOTE) 

call Put_Output 

rect 
Put_QUOTE endp 
aa aM EN Ma PO A OL A DON GC MED ORO OU oe 209 05 
; Put_TERM: 
; sent a right parenthesis and CrLf to the ouptut device 
4 return the STATUS in AL, if <> E_OK then set the carry flag 
FLEE REDE DE TERRE ERERD ECR EREER DO bE FC FUN £ TOLEDO ENE RUE POF 6 bunlouraels Chel Aie T) nieeenrie 
Put_TERM proc near 

mov SI, offset (TERM) 
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ze 


call Put_Output 
ret 
Put_TERM endp 


PILOT REO ERNE BAP ER Fa ES BLOONS So Sh Ota A ote ue cls dh Sey Cae nies Paine 4 a me 
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; Put Fixed: 


: enter with AX holding a fixed place word 
; convert the fixed place word to an ASCII text stream-> XX.XXX 
; send the text stream to the output 
; return the STATUS in AL with the carry set if <> E_OK 
Put_Fixed proc near 

xor BX, BX 

cmp AX, 9999 

jle PF_Thousands 

xor DX,DX 

mov CX, 10000 

div CX 

xchg AX, DX 

add DL, ‘0° 

mov ASCII_FIXED[BX],DL 

inc BX 
PF_Thousands: 

xor DX, DX 

mov CX,1000 

div CX 

xchg AX, DX 

add Diigas Oi 

mov ASCII_FIXED[BX],DL 

sifo¥e! BX 

mov AS CETL XE DB Xp eure! 

inc BX 

xor DX,DX 

mov Cx, 100 

div CX 

xchg AX, DX 

add afi By AMO) Y 

mov ASCII_FIXED[BX],DL 

ENC BX 

or AX, AX 

WZ PF_ Null 

xor DX, DX 

mov CX, 10 

div CX 

xchg AX,DX 

add DL, *0}! 

mov ASCII_FIXED[BX],DL 

inc BX 

or AX, AX 

Jz PF_Null 

add AL, '0' 

mov ASCII_FIXED[BX],AL 

ince BX 
2S isibalabe 

mov ASCII_FIXED[BX],0 

Mov SI,offset (ASCII_FIXED) 

call Put_Output 

ret 


c 
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; Put_Word: 
; enter with AX holding a Word 
; convert the word to an ASCII text stream-> XXXXX 
; send the text stream to the output 
; return the STATUS in AL with the carry set if <> E_OK 
Put_Word proc near 
xor BX, BX 
cmp AX, 9 
jle PW_Units 
cmp AX, 99 
jle PW_Tens 
cmp AX, 999 
jle PW_Hundreds 
cmp AX, 9999 
jle PW_Thousands 
xor DX,DX 
mov CX, 10000 
div CX 
xchg AX,DX 
add jap, Ui) 
mov ASCII _Word[BX],DL 
inc BX 
PW_Thousands: ag 
xor DX, DX 38 Cc 
mov CX, 1000 aif Ne 
div Ox 4 
xchg AX,DX 
add DL, '0' 
mov ASCII Word[Bx],DL 
inc BX 
PW_Hundreds: 
xor DX, DX 
mov Cx,2100 
div CX 
xchg AX, DX 
add Dit On 
mov ASCII _Word[Bx],DL 
inc BX 
PW_Tens: 
xor DX,DX 
mov CX, 10 
div CX ae 
xchg AX, DX id 
add jojiay, U0) Cr. 
mov ASCII_Word[BX],DL L¢ 
inc BX bi 
PW Units: 
add - AL, '0' ei 
mov ASCII_Word[BX],AL Wes 
ane BX re 
mov ASCII_Word[Bx],0 
mov SI,offset (ASCII Word) 
call Put_Output 2) 
rec 


D-76 


INDEX 


A 
Abandon edits 4-79 
Add 3-15, 4-20, 4-72, 5-9 


. AGAIN 4-6 


AGAIN © 
LIBEDIT 7-10 
Algorex 6-45 
ANNOTATE 1-4, 5-20, 6-7 to 12, 
8-46, 8-47 
Annotation file 5-28, 5-35, 6-13 
Applicon 6-45 
Auto pan 4-85 


B 
BACKANNO 1-4, 6-14 to 17, 8-46, 
8-50 
~ Backup file 4-85 
Battery backup 6-74 
Bill of Materials (see PARTLIST) 
Bitmaps 7-9 
BLOCK 4-7 
BLOCK 
drag 4-8 
export 4-12 
fixup 4-8 
get 4-11 
import 4-12 
move 4-7 
save 4-11 
Block symbols 7-60 
BODY 7-6 
BODY 
LIBEDIT 7-11 
Bus entry 4-63 
Buses 
combining labels 6-66 
connecting to module ports 6- 


63 to 65, 67 to 68 
labeling 6-61 to 63 
multiple labels 6-66 
placing 4-61 
splitting 6-65 to 66 


C 
Cadnetix 6-45 
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